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Manual Objectives 

DECnet/E is a combination of hardware and software that extends the capa- 
biUties of a RSTS/E system on a DIGITAL PDP-11 computer to allow com- 
munication with other DECnet systems in a network. This manual 
describes the DECnet/E utilities that allow a terminal user to talk to a user 
locally or at another node, log in at and use another DECnet/E node, manip- 
ulate files between nodes, and copy the contents of entire disks and tapes 
between devices at different DECnet/E nodes. 

Intended Audience 

This manual is written for the nontechnical RSTS/E terminal user who 
wishes to use the DECnet/E facilities to access remote systems within his 
network. The reader is expected to have a basic understanding of the oper- 
ation of the local RSTS/E system, as well as that of the remote system being 
accessed, but is not expected to be a sophisticated computer user or 
programmer. 

Related Documents 

The terminal user who wishes to use the DECnet/E utilities will find all the 
information necessary to do so in this manual. To obtain a general under- 
standing of the DECnet environment, however, the reader is directed to the 
following manual: 

Introduction to DECnet, Order No. AA-J055B-TK 

DECnet/E also provides message services that allow a programmer to 
develop programs that exchange data with programs running on other DEC- 
net systems in a network. These features are described in four companion 
manuals: 

DECnet/E Network Programming in BASIC-PLUS and 

BASIC-PLUS-2, Order No. AA-H501B-TC 

DECnet/E Network Programming in MACRO-11 , 

Order No. AA-L265A-TC 

DECnet/E Network Programming in FORTRAN, 

Order No. AA-L266A-TC 

DECnet/E Network Programming in COBOL, 

Order No. AA-H503B-TC 

Two other companion manuals tell how to generate and start a DECnet/E 
system, control and monitor a running DECnet/E system, and give other 
information useful to a system manager. 

DECnet/E Network Installation Guide, Order No. AA-K714A-TC 
DECnet/E System Manager's Guide, Order No. AA-H505B-TC 
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Structure of This Manual 

This manual is structured as a reference guide. It is divided into chapters, 
one for each available network utility. The function and capabilities of each 
utility are described and step-by-step instructions are presented for their 
use. 

Documentation Conventions 

Throughout this manual, the following documentation conventions are used 
to describe keyboard input: 

UPERCASE Uppercase letters indicate keywords that must 

be entered as shown. 

lowercase Lowercase italic letters represent items that 

must be replaced according to the accom- 
panying description. When an item requires a 
descriptor or more than one word, the descrip- 
tor is hyphenated. For example, file- 
specification. 

[ ] Square brackets enclose an optional field that 

need not be included. In general, brackets are 
logical symbols only and should not be included 
in the input. Brackets surrounding a project- 
programmer number, however, must be 
included. 

{ } Braces indicate a choice of input items, one of 

which must be specified. 

red/black User input is shown in red. Program output 

(prompts and displays) is shown in black. 

CTRL/ The character string "CTRL/" followed by a let- 

ter indicates a control character (for example, 
CTRL/Z). Control characters are generated by 
depressing the CTRL key and the appropriate 
letter key at the same time and are echoed on 
the console display as a caret (") followed by the 
letter (for example, "Z). 

Unless shown otherwise, spaces or tabs must separate items in a command 
string. More than one space or tab between items is treated by the system as 
a single space. Also, although it is not shown in this manual, you must fol- 
low the last item of input in a command string with a carriage return. 
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Chapter 1 
Introduction 



This manual tells how to use DECnet/E utilities to perform the following 
operations: 

1. Communicate with someone at a terminal on another DECnet system 
that has a compatible receiver utility. Each person can type messages 
that will be displayed at the other's terminal (see TLK, Chapter 2). 

2. Do work on another DECnet/E system as if your terminal were con- 
nected directly to the other system (see NET, Chapter 3). 

3. Copy files to or from other DECnet systems, submit command files to 
other systems, and delete files at other systems (see NFT, Chapter 4). 

4. Copy the contents of an entire storage device to or from another 
DECnet/E system (see NETCPY, Chapter 5). 

5. Shut down the network in an orderly fashion (see NETOFF, Chapter 
6). 



oo 

DECnet/E 
SYSTEM 



LOG INTO AND 
USE ANOTHER 
DECnet/E SYSTEM 



c*':^ 




TLK> MURRAY - MOUNT A TAPE 



>NFT DENVER::FILE=MYF:|LE 




TALK TO 
REMOTE USERS 



MANIPULATE 
NETWORK FILES 
COPY DEVICES 



Figure 1-1 DECnet/E Features for the Terminal User 
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1 . 1 Basic Terms and Concepts 

The term network is used here to refer to two or more computer systems con- 
nected so that they can exchange information. The computer systems, called 
nodes, are connected by communications paths called physical links. Phys- 
ical links can be established through normal (switched) telephone circuits, 
several varieties of leased (private) lines, coaxial cables, or even satellite 
transmission facilities provided by several carriers. 

In the network shown in Figure 1-2, a user at node BOSTON would refer to 
BOSTON as the local node and to nodes DENVER, DALLAS, LONDON, 
and LA as remote nodes. At node BOSTON, the nodes DENVER, DALLAS 
and LONDON are physically adjacent nodes. That is, there is a direct phys- 
ical link to these nodes with no intervening nodes. To a user at node LA, 
DENVER is the only adjacent node. 

A path is the route over which data travels from its source to its destination 
within the network. Path length is the distance from the source node to the 
destination node, measured in hops. A hop is equal to a physical line 
between two adjacent nodes. In Figure 1-2, the path length between nodes 
DALLAS and BOSTON is one hop and between LA and LONDON is three 
hops. The network diameter is the maximum path length between any two 
nodes. The network shown in Figure 1-2 has a network diameter of three 
hops. 

The utilities described in this manual establish logical links to communicate 
with their counterparts at remote nodes. A logical link is a software path for 
the exchange of data between two programs running in a network. DEC- 
net/E Version 2.0 is a Phase III DECnet product. (Refer to Introduction to 
DECnet for a discussion of the differences between Phase II and Phase III 
DECnet products.) As such, it supports the adaptive routing feature of 
Phase III, providing the user with the capability of communicating with 
other Phase III nodes in the network, regardless of whether or not they are 
directly connected to the local node. 
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Figure 1-2 Computer Network Composed of Five Nodes. 



1 .2 DECnet Networks 



DECnet as a whole refers to the hardware and software that allows different 
DIGITAL systems to be connected to form networks. DECnet has been 
designed to allow each system to function as a separate entity but still allow 
access to resources that are distributed throughout the various computer 
systems in the network. A DECnet/E system provides all the capabilities of 
a normal RSTS/E system plus the networking capabilities described here 
and in the companion DECnet/E manuals listed in the Preface. 

All DECnet implementations are based on a design structure called the 
DIGITAL Network Architecture (DNA). This architecture allows network 
implementations on the various DIGITAL systems to evolve (to provide 
more and more capability as time goes on) within a basic common structure. 
The structure ensures that implementations providing fewer features will 
always work with implementations providing more. 

Perhaps a more immediate aspect of this process of evolution, however, is 
that at any given time capabilities can indeed differ from system to system. 
The DECnet implementations for all the different DIGITAL systems are not 
described here. Nevertheless, to use the DECnet/E utilities, you do need to 
give some thought to other DIGITAL systems in your network. 
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If your network consists entirely of DECnet/E Version 2.0 nodes, this docu- 
ment provides all the information you need to use the DECnet/E utilities. If 
your network contains other DECnet systems, however, you will need to 
check the DECnet documentation for the other systems to be sure that the 
corresponding capabilities exist. 

The DECnet/E utilities TLK and NET are designed and implemented 
according to the protocols defined as part of the DIGITAL Network Archi- 
tecture. You can use them with non-DECnet/E systems as long as the corre- 
sponding feature is implemented in that system. The DECnet/E utilities 
NET and NETCPY, on the other hand, are networking features unique to 
DECnet/E and will work only with other DECnet/E systems. 

A brief overview of the functional capabilities of the various DECnet imple- 
mentations can be found in Introduction to DECnet. 

1 .3 The DIGITAL Network Architecture (DNA) 

DECnet/E is implemented according to a set of rules, or protocols, governing 
the format, control, and sequencing of data exchange from the user program 
level down through the physical link level. These protocols are defined by 
the DIGITAL Network Architecture (DNA) - a logical structure that pro- 
vides the model for all DECnet implementations. 

DNA consists of several layers, each defining a distinct set of network func- 
tions and a set of rules for implementing those functions. Each DECnet 
implementation consists of software modules that perform these DNA- 
defined functions according to DNA-defined protocols. 

At the lowest layer, physical link control is achieved in DECnet by imple- 
mentation of the Digital Data Communications Message Protocol (DDCMP). 
DDCMP ensures an error-free, sequential data path over a generally error- 
prone medium. This is accomplished with the Cyclic Redundancy Check 
(CRC) for error detection, retransmission for error corrections, and num- 
bered data segments to ensure sequential transmission of data. 

The Network Services Protocol (NSP) defines the rules for communication 
between programs in a network over paths called logical links. Logical links 
are described in detail in the network programming manuals for the various 
DECnet/E language interfaces, as named in the Preface. Briefly, logical 
links allow many different data streams to be multiplexed for transmission 
over the physical link and separated at the receiving node for delivery to the 
appropriate program. The utilities described in this manual communicate 
using logical links. 

The Transport protocol defines the rules for determining the actual physical 
path, or route, along which data travels to its destination. 

The Data Access Protocol (DAP) defines conventions for DECnet utilities 
that transfer and manipulate files. This protocol includes a specific language 
that these utilities use to transfer commands and data. The NET and FAL 
utilities described in this manual communicate according to the DAP 
protocol. 

1-4 DECnet/E Guide to User Utilities 



1 .4 Network Routing 



DECnet/E Version 2.0 is a Phase III DECnet product. (Refer to Introduction 
to DECnet for a discussion of the differences between Phase II and Phase III 
DECnet products.) As such, it supports the adaptive routing feature of 
Phase III, providing the user with the capability of communicating with 
other nodes in the network regardless of whether or not they are directly 
connected to the local node. 

Networks can consist of the following three types of nodes: 

• Routing nodes - Phase III nodes connected to multiple communications 
lines, supporting route-through capabilities. 

• Nonrouting nodes (end nodes) — Phase III nodes connected to a single 
communications line. 

• Phase III nodes - nodes running a previous generation of the DECnet 

architecture. 

Phase III nodes can communicate with and are compatible with Phase II 
nodes. However, Phase II nodes do not acquire any new capabilities by being 
connected to Phase III nodes, and the restriction that Phase II nodes can 
only communicate with adjacent nodes continues to apply. Thus, a Phase III 
node can communicate with any other Phase III node, providing the path 
goes through Phase HI nodes only. 

The adaptive routing feature is implemented through an algorithm that 
chooses the routing path with the lowest associated cost. Cost is computed as 
the sum of the costs of the lines over which the message is transmitted. The 
individual line cost parameters are assigned by the system manager and 
input into the system using the Network Control Program (NCP). (See the 
DECnet/E System Manager's Guide for a full discussion of line costs.) The 
algorithm automatically adjusts the routing when network topology or line 
cost changes occur. 



1 .5 Overview of DECnet/E Structure 

You do not really need to know how DECnet/E is implemented to use the 
utilities described in this manual. It is probably useful, however, to have 
some appreciation for how the utilities themselves fit into the overall DEC- 
net design and implementation. 

As mentioned before, the utilities described in this manual communicate 
over the network using logical links. The DECnet/E implementation of the 
Network Services Protocol, that provides the capability for establishing log- 
ical links, is a part of the RSTS/E monitor. Although it is not a separate 
entity or program in DECnet/E, the term NSP is used in this manual and 
the companion DECnet/E manuals to refer to the software that allows a user 
program to establish and exchange data over logical links. In other words, 
NSP is the implementation of the Network Services Protocol. 
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NSP, the utilities described in this manual, and NCP, the Network Control 
Program (described in the DECnetlE System Manager's Guide), are visible 
to the user. To code a program that exchanges information with another pro- 
gram, a programmer uses calls that NSP executes. A terminal user runs 
TLK, NFT, NETCPY, and NET to use their services. The system manager 
runs NCP to start, monitor and control the local node and other nodes in the 
network. 

Some elements of DECnet/E, however, are not directly accessible to any 
user. These lower level elements of DECnet/E include the Transport module 
(TRN), that implements the Transport protocol, several hardware devices 
(the DMCll, DMRll, DMVll, and DMPll) and their associated software 
device drivers. 

The device drivers are responsible for handling messages received from and 
sent over the physical communication lines. NSP gives an outgoing message 
to Transport, and Transport selects an appropriate data path based on the 
destination of the message. Transport then passes the message to the proper 
device driver for actual transmission. The drivers manipulate the device 
registers to cause message transmission to occur. 

To handle incoming messages, the drivers include buffer management func- 
tions that allow messages to be received from the physical links. When a 
message is received, it is passed to Transport, and Transport checks the des- 
tination of the message. If the message is for the local node. Transport 
passes it to NSP for further processing. If the message is destined for 
another node in the network. Transport selects a data path and passes the 
message to one of the drivers for transmission. 

The hardware devices are intelligent communication controllers that con- 
nect the PDP-11 to physical communication lines. The DMCll and the 
DMRll control lines that connect to only one other system in the network 
(point-to-point lines) while the DMVll and the DMPll control lines that 
can connect to more than one other system (multipoint lines). The physical 
lines can include cables, modems and telephone circuits, or even satellite 
transmission facilities. Each controller contains a microprocessor, its own 
memory, and microcode that implements the DDCMP protocol. The imple- 
mentation of DDCMP in firmware considerably reduces the software over- 
head for the DECnet/E system. 
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Chapter 2 

TLK: Terminal Communication Utility 



The TLK utility lets you send messages to another person at any other ter- 
minal in the network, including the Operator Services Console (OSC), pro- 
vided that the system to which the remote terminal is connected has a 
utility designed to receive such messages. Two communication modes are 
available. 

1. One-line mode allows transmission of a one-line message to another 
terminal. 

2. Dialog mode allows two-way communication between two terminals. 
The dialog can be stopped at any time by the person at either 
terminal. 

The TLK utility is implemented as two programs in the RSTS/E environ- 
ment: TLK (Talk) and LSN (Listen). Figure 2-1 shows a sample conversa- 
tion in dialog mode, and also illustrates the general relationship of TLK and 
LSN. TLK is executed at a RSTS/E node at the direct request of one of the 
local terminal users. LSN is executed to complete a connection requested by 
a TLK program. 





RUN $TLK 

EAST::KB41: 
>HELLO, EAST COAST! 
>DID YOU GET THE TAPES YET? 
> 

YES! GOT THEI« YESTERDAY. 
>GREAT. BYE FOR NOW. 

<TLK> End of Dialogue 



Figure 2-1 : The TLK Utility: TLK and LSN Provide Communication 
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2.1 One-line Mode 



Using the TLK utility in one-line mode, you can transmit one line of infor- 
mation to another terminal. The following subsections describe the input 
required to initiate a message and the output displayed at the receiver's 
terminal. 



2.1.1 Initiator's Input 

To send a one-line message to another terminal, t3^e: 



RUN $TLK 

TLK V2.0 RSTS V7.1 Timesharing NSP 

*{target-node::][target-terminal\\ 'message 



ONE-LINE MODE: 
MESSAGE, PRECEDED BY A 
SINGLE QUOTE, ON SAME LINE 
AS TARGET INFORMATION 



If TLK has been installed as a Concise Command Language (CCL) com- 
mand, you can also type 

TLK [target-node::][target-terminal:] 'message 

In either case, the length of a line cannot exceed 132 characters. 

The target-node is the 1- to 6-character ASCII node name to which the mes- 
sage is to be sent. If the local node is the target, the node name can be 
omitted. If a node name is given, the two colons (::) must be used. (The 
names of nodes that are currently active on the network can be determined 
with the NCP command, SHOW ACTIVE NODES. See the DECnetlE 
System Manager's Guide.) 

The target-terminal is the device designation of the terminal to which the 
message is to be sent (for example, TT5: or KB41:). If the operator's console 
is the target, the target terminal can be omitted. TLK will then automati- 
cally send the message to the operator's console at the node specified. (Under 
the RSTS/E system, for example, the operator's service console can be 
assigned to different physical devices at different times for the operator's 
convenience. By not specifying a specific device, such as KBO:, you ensure 
that the message reaches the current operator's console device.) 

If the node specified is the local node, TLK will check to make sure the tar- 
get terminal specified is a terminal known to the system. The usual designa- 
tion for terminals under the RSTS/E system is KBn: or TTn:, where n is the 
physical terminal number. However, logical names established with an 
ASSIGN command can also be used for target terminals at the local node. 
(See the RSTS/E System User's Guide for a discussion of logical device 
names.) 
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If the node specified is a remote node, TLK extracts only the decimal termi- 
nal number from the target terminal specification and forwards that num- 
ber to the TLK (or LSN) program at the remote node. The remote node's 
TLK (or LSN) utility will return an error if the device number is invalid for 
that node. 

The message is any ASCII string; it is the message to be transmitted. The 
message must be preceded by a single quote and cannot extend beyond the 
end of the current line. Leading and trailing blanks and tabs will be deleted. 
(The entire line cannot exceed 132 characters.) 

Example: 

The following example shows a one-line message sent from the local node 
(known as MAYNRD on the network) to terminal KB5: at a remote node 
called SANFRN. 

RUN $TLK 

TLK V2.0 RSTS U7.1 Tiwesharins NSP 

♦SANFRN: :KB5: 'Relay «■/ calls to (B17) 123-45G7. Sheldon. 

The following example shows a one-line message sent to the operator's serv- 
ice console at the local node: 

TLK 'MOUNT TAPE MM015 ON UNIT MMl: 



2.1.2 Receiver's Output 

A one-line message targeted to a RSTS/E terminal is displayed as follows: 

<TLK> source-node:: source-terminal: message 

The source-node is the name of the node where the message originated. It is 
omitted if the message came from the local node. The source-terminal is the 
device designation of the terminal from which the message originated. The 
message is the ASCII message. 

The LSN program at the RSTS/E node sends the message to the designated 
terminal. If the terminal is busy, the executing program is not halted but 
the message is displayed regardless of whatever else may be going on. That 
is, the line can be displayed with other text being displayed at the terminal. 

A message arriving for the local node's operator services console when 
OPSER (the operator services program) is running is displayed in the usual 
OPSER format: 

MESSAGE nnnnn:date time JOB:ren jobnamelppn] 
<TLK> source-node:: source-terminal: 
'message 

If OPSER was not installed as part of the RSTS/E system, or if for some rea- 
son it is not running, the message will be broadcast to KBO: in the ordinary 
format. 
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(OPSER provides various capabilities useful to a computer operator or sys- 
tem manager. The program is described in detail in the RSTS/E System 
Manager's Guide.) 

Example: 

Assuming that the first one-line message in the previous example arrived at 
a RSTS/E node, the message would appear as follows: 

<TLK> MAYNRD:: KB4: 'Relay my calls to (617)123-4567. Sheldon. 

If OPSER is running, the second one-line example would appear at the local 
node as follows: 

MESSAGE 23402 : 19-Mar-82 12:45 PM JDBi:13 TLKC122»100] 
<TLK> MAYNRD: : KB4: 
'MOUNT TAPE MM015 ON MMl: 



2.2 Dialog Mode 



Using the TLK utility in dialog mode, you can enter into an exchange with a 
user at another terminal. The following subsections describe the input 
required to initiate such a dialog, as well as the output displayed at the 
receiver's terminal and the input required from the receiver to continue the 
conversation. 



2.2.1 Initiator's Input 

To initiate a dialog with a person at another terminal, type the following: 

RUN $TLK 

TLK V2.0 RSTS V7.1 Timesharing NSP 

*[target-node::][target-terminal:] 

> message 



DIALOG MODE: FIRST 
MESSAGE ON LINE AFTER 
TARGET INFORMATION, NO 
SINGLE-QUOTE NEEDED 



If TLK has been installed as a Concise Command Language (CCL) com- 
mand, you can also type the following: 

TlKitarget-noderJiltarget-terminalA 
> message 

The target-node, target-terminal, and message input parameters are the 
same as for one-line mode except that the message does not require the pre- 
ceding single quote. 
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Wait for the > prompt from TLK before tj^ing the first line of the message. 
TLK will continue prompting for new lines with this character. Returned 
messages from the receiver end of the dialog will be displayed as lines inter- 
spersed with the initiator's lines (see the example that follows) until one or 
the other types a CTRL/Z in response to a > prompt. 

Example: 

The following example shows a typical dialog and how the conversation pro- 
ceeds from the initiator's end. 

TLK MAYNRD: : KB4: 

> S h e 1 d ri - - a call c a w e 1 o n 3 - d i s t a n c e ! couldn't be transferred. 
> 

Oh. Who was it» did they leave a number to call back? 

> Y e 5 - - G 1 a d y s F r e e n of F e r n ) Fern* F r e e n > and Fern. Call 
> (415)987-6543 after 10:00 C1:00 pm your time). 

> 

QK--thaflKs aSain. Sheldon. 

<TLK> End of Dialos 

Ready 

(The dialog was terminated by the receiver in this example.) 



2.2.2 Receiver's Interaction 

If the target terminal is not busy (no one is logged in), the RSTS/E LSN pro- 
gram displays the first line of a dialog-mode message as follows: 

<TLK> in Dialog with source-node:: source-terminal: 

> 

message-1 

You can then continue the dialog by typing a return line in response to a > 
prompt. 

If the receiving terminal is busy (someone is logged in at the terminal), the 
following display is made: 

<TLK> in Dialog with source-node:: source-terminal: 

T5T)e TLK/ra source-node:: source-terminal:' to continue dialog 

The material in single quotes is what should be typed to continue the dialog. 
For example, TLK/6 NOD5::KB12:, LSN will then wait up to two minutes 
for the dialog to be continued. You can stop what you are doing at the termi- 
nal and type the indicated command to continue the dialog, or you can go to 
another terminal, log in, and type the indicated command to continue the 
dialog. The number n following the slash is the job number of the copy of the 
local LSN that is waiting for the response to continue the dialog. At least 
one space must be tyjied after the job number. 

You actually run TLK when you type the command for continuing the dia- 
log. TLK tells the waiting LSN utiltiy that the dialog will continue and 
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identifies the terminal from which it will continue. TLK then detaches from 
the terminal so that LSN can control the interactive dialog. TLK and LSN 
are separate jobs in this case. Both are terminated when the dialog is 
stopped by either user. When the dialog is complete, LSN kills itself and 
TLK reattaches to the terminal and exits. 

You can also choose to continue the dialog with the RUN $TLK speci- 
fication: 

RUN $TLK 

TLK V2.0 RSTS V7.1 Timesharing NSP 

*/6 NOD5::KB12: 



Once the line is typed, the first message is displayed and the dialog contin- 
ues in the usual manner until either person types a CTRL/Z in response to a 
> prompt. LSN then breaks the connection and displays the following 
message: 

<TLK> End of Dialog 

If the receiving terminal is the local operator services console and the 
OPSER routine is running, the display for a busy terminal is made in the 
standard OPSER format: 

MESSAGE nnnnn'.date time JOBmnjobname-ppnJ 

<TLK> in Dialog with source-node:: source-terminal: 

Type 'TLK/n source-node:: source-terminal:' to continue dialog 

Operation will then proceed as for a busy terminal. 

Example: 

The following example illustrates how the conversation from the previous 
example might have looked from the receiver's end. (The user is logged in, 
entering text with an editing program.) 



* I/And so . after/ 

<TLK> in Dialos with SANFRN:: KB5: 

Type 'TLK/13 SANFRN:: KB5:' to oontinue dialoS 



♦exit \ 

\ 



/ 
/ 
Ready / 



'^ (user exits from the editor 
and starts TLK) 
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TLK/13 SANFRN::KB5: 

> 

SheldQn--a call came 1 on 3-d ist ance i couldn't be transferred! 

>0h. Who was it* did the'/ leaue a number to call baoK? 

> 

Yes--Gladxs Freen of Fern> Fern* Freen* and Fern. Call 

> 

<415)987-B5fl3 after 10:00 (1:00 pm your time). 

>0K--thanK5 a3ain. Sheldon, 

>CTRL/ 

<TLK> End of DialoS 

2.3 TLK Error Messages 

Command syntax error - Illegal job number- /n 

The job number you typed to continue a dialog is not a valid RSTS/E job 
number. Check the display that TLK printed and retype the line to con- 
tinue the dialog. 

Command syntax error - Illegal message 

This error occurs if you try to type a message on the same line as the exe- 
cute line for continuing a dialog. Retype the command line. When TLK 
prints the > prompt, you can then type the message you want sent. 

Command syntax error - Illegal node name - nodename 

The node name specified in a command line is not recognized by TLK. 
Retype the line with the correct node name. 

Command syntax error - Illegal terminal specification - spec 

The terminal specification shown (spec) is incorrect. Retype the com- 
mand line. 

Command syntax error - Job n is not a message receiver 

The job number typed to continue a dialog is a valid job number but the 
job is not a message receiver. Check the display that TLK printed and 
retype the line to continue the dialog. 

Command syntax error - Job n does not meet dialog requirements 

The job number typed to continue a dialog is a valid job number, and the 
job is a message receiver, but the job is not the same one that initiated 
the dialog. Check the display that TLK printed and retype the line to 
continue the dialog. 

Command syntax error - Message too long 

The maximum line that TLK will accept is 132 characters. Retype the 
message with shorter lines. 
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Connect Initiate error - text 

TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages, but it got an error on the initial connection request. 
The text is the error text TLK got in response to its attempt to send a 
Connect Initiate Message. (See DECnet/E Network Programming in 
BASIC-PLUS and BASIC-PLUS-2 for further description of the error 
text.) 

Connection rejected by NSP - Code:n 

TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote NSP. 
The code n is the reason code that the remote NSP returned in its rejec- 
tion. Appendix B lists the meanings for the various NSP error codes. 

Connection rejected by remote TLK - Code:n 

TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote TLK 
or LSN. The code n was returned in the rejection and its meaning 
depends on the remote TLK. Contact a DIGITAL Software Support rep- 
resentative if this error occurs repeatedly. 

Connection rejected by remote TLK - Illegal value in TLK mode byte 

TLK tried to set up a logical link with the remote TLK or LSN to 
exchange messages but the connection was rejected by the remote TLK 
or LSN. Contact a DIGITAL Software Support representative if this 
error occurs repeatedly. 

Connection rejected by remote TLK - Terminal is busy 

This error occurs when you have initiated a dialog and the remote termi- 
nal is busy, but no one has responded to continue the dialog. (The remote 
user is allowed two minutes to respond and continue the dialog; in this 
case, no one did.) 

Connection rejected by remote TLK - Terminal is nonexistent 

The remote terminal requested does not exist at the remote node. Check 
for possible error in the command line. 

Connection rejected by remote TLK - text 

The remote TLK or LSN could not accept the logical link connection that 
would allow the one-line or dialog exchange. The text is the error mes- 
sage that the remote TLK or LSN got in trying to issue its connect con- 
firmation. If this error occurs often, contact a DIGITAL Software 
Support representative. 
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Connection rejected by remote TLK - Unknown format 

The remote TLK did not recognize the parameters passed in the request 
to set up a logical link that would allow the one-line or dialog exchange. 
This could occur if the remote TLK is part of a Phase I implementation of 
DECnet - an earlier implementation than the local TLK/DECnet. Con- 
tact a DIGITAL Software Support representative. 

Declare Receiver error - text 

The local TLK could not begin to set up message exchange facilities at 
the local node. The text is the text of the error message received in its 
Declare Receiver system call. 

DECnet Is not Installed 

DECnet was not installed at system generation time. No network func- 
tions can be executed. 

Dialog already continued by job n, account[ppn], from KBn: 

You or someone else has already typed the line requesting a dialog con- 
tinuation. The account number and terminal number can be used to 
determine who continued the dialog and from which terminal. 

Disconnected by remote TLK - Code:n 

The logical link allowing the one-line or dialog exchange has been dis- 
connected by the remote TLK. The code n was returned by the remote 
TLK in its disconnection. Contact a DIGITAL Software Support repre- 
sentative if this error occurs repeatedly. 

Disconnected by remote TLK - Transfer error 

An error occurred at the remote site in transferring a message to or from 
the remote terminal. Contact a DIGITAL Software Support representa- 
tive if this error occurs often. 

Job n Is not In dialog with specified target 

In continuing a dialog, you typed the wrong terminal or node name. 
Check the display that TLK printed and retype the command line. 

Linit aborted by NSP - Code:n 

The logical link allowing the one-line or dialog exchange has been 
aborted. The coden is the reason code supplied by NSP in the Link Abort 
Message terminating the link. Appendix B lists the meanings for the 
various NSP error codes. 
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Link could not be established - Timeout 

Two minutes went by after the remote TLK printed its message for con- 
tinuing a dialog and no one responded. The dialog was timed out. 

Link could not be established - text 

The local TLK got an error in receiving a Connect Confirm Message from 
the remote TLK (or LSN). The logical link that would provide the one- 
line or dialog exchange could not be set up. The text is the NSP error 
message that the local TLK got on its Receive system call. Contact a 
DIGITAL Software Support representative. 

■Message too long 

A line typed in dialog mode was longer than 132 characters. Retype the 
message using shorter lines. 

NSP is not enabled 

NSP, the part of DECnet that would allow the logical link connections 
providing the one-line or dialog exchange, has not been enabled at the 
local node. See the system manager. 

Receive error - text 

The local TLK (or LSN) got an error in receiving a message from the 
remote end. The text is the error message returned on the Receive system 
call. Contact a DIGITAL Software Support representative. 

Send data error - texf 

The local TLK (or LSN) got an error in sending a message to the remote 
end. The text is the error message returned on the Send Network Data 
Message system call. Refer to DECnet/E Network Programming in 
BASIC-PLUS and BASIC-PLUS-2 for further details of the error text, 
and contact a DIGITAL Software Support representative. 



2-1 DECnet/E Guide to User Utilities 



Chapter 3 

NET: Network Command Terminal Utility 



The NET utility lets you access another DECnet/E system in the network 
and do work there as if your terminal were directly connected to the other 
system. 




IT 




RSTS/E 
NODE 



NET 



RSTE/E 
NODE 



NPKDVR 



RUN$NET 

Node Name? BOSTON::HELLO 

#2/218 

Password? (not echoed) 

Ready 



USER 
JOB 
(PK:) 




Figure 3-1 NET Provides Access to Another DECnet/E Node 



NET is implemented as two programs: NET and NPKDVR. Figure 3-1 
shows a user running NET at node DENVER. NET requests a logical link 
with NPKDVR at the remote node BOSTON. NPKDVR opens a pseudo- 
keyboard at node BOSTON and accepts the connection requested by NET. 
Once the connection is established, information that the user types at the 



3-1 



keyboard in DENVER is relayed over the logical link to NPKDVR, which 
relays it to the pseudo-keyboard. The RSTS/E system at BOSTON treats a 
pseudo-keyboard as a normal keyboard. When the RSTS/E monitor receives 
information from the pseudo-keyboard (whatever the user types at node 
DENVER), it creates a job and runs LOGIN to process the input. The 
responses made by the monitor, LOGIN, and whatever else the user runs, 
are directed to the pseudo-keyboard. NPKDVR, in turn, passes responses 
directed to the pseudo-keyboard back over the logical link to the NET pro- 
gram. NET then displays it at the user's terminal. 

NOTE 

Except for the special CTRL/P character and its related 
commands (discussed in the sections that follow), user 
input is passed directly through to NPKDVR on the remote 
system. NET makes no attempt to interpret any of the data 
it passes through. Thus, if the user types a system-level 
command, for example, the command is executed at the 
remote system and has no eflfect on the local system. 

NPKDVR is itself a job. To reduce overhead, a system manager can install 
one or more permanent copies of NPKDVR at a node. Each such per- 
manently installed copy can handle multiple logical links. When such copies 
are all busy, an incoming connection request causes a temporary copy to be 
automatically started. (See the discussion of the SET/DEFINE OBJECT 
command in DECnetlE System Manager's Guide for further information on 
installing programs for automatic startup.) 



3.1 Running NET 



You can run NET from any terminal in a DECnet/E system by typing the 
following command: 

RUN$NET 
NET responds by identifying itself and then outputing the following prompt: 
Node Name? 

Type a node name, followed by two colons and, optionally, an initial string of 
characters to be forwarded to the remote node. When the connection is 
established, NET prints the following message: 

Connection established to RSTS/E Node nodename 

You can then proceed as though directly connected to the remote RSTS/E 
node. 

If NET has been installed as a Concise Command Language (CCL) com- 
mand, you can also run NET by typing the following command: 

NET [nodename{::[string]'\] 
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If you are running under the DCL Run-Time System, you can also connect to 
a remote node by typing the following command: 

SET HOST [nodename[::[string]]] 

Once the connection to the remote DECnet/E node is established, you are 
logically connected to the remote node. You can log in, run programs 
(including NET to establish a connection at yet another DECnet/E node), 
and log out. You can use the special character CTRL/P (Control-P) followed 
by the RETURN key to escape to the NET program at the local node without 
breaking the connection to the remote node. NET will then accept one of the 
commands described in Section 3.2. 

NOTE 

To run a program at the remote node that opens the 
keyboard using field control, echo control, or binary modes 
(as described in the RSTS/E Programming Manual), you 
must first use the ODT command to enter a special trans- 
mission mode (Section 3.2.6). This places a heavy load on 
the network, however, and should only be used as needed. 



3.2 NET Commands 



If you type CTRL/P, followed by RETURN, while using a remote RSTS/E 
node, you will temporarily return to the NET program at the local node. The 
connection to the remote node is not broken, but any characters you type 
will be processed by NET at the local node rather than being forwarded to 
the remote node. NET displays the following prompt: 

nodename: : NET> 

The parameter nodename is the name of the "local" node. (If you are using 
NET to run NET at another remote node, this is the name of the node at 
which the remote NET is processing a CTRL/P command. See Section 3.2.2.) 
You can then type one of the following six commands. These commands are 
listed below and described in the sections that follow: 

CONTINUE Continue transmission of input to remote node. 

CTRL/P Transmit a Control-P character to the remote node 

EXIT Terminate transmission to the remote node and exit from 

the NET program. 

HELP Display instructional information. 

NORMAL Resume normal transmission to remote node, one line at a 

time. 

ODT Begin transmission to remote node, one character at a time. 
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3.2.1 CONTINUE Command 

This command causes the NET program to stop displaying its "NET>" 
prompt and resume sending the data typed at the local terminal over the 
connection to the remote node. 

Example: 

RUN $NET 

NET U2,0 RSTS ^7.1 DECnet System 

Node name? BOSTON 

Connection established to RSTS/E Node BOSTON 

HELLO 

RSTS M7.1 Timesharing Job 31 KB33 15-AuS-81 8:00AM 

»2/218 

Password: (not echoed) 



Ready 



•P 

DENVER: !NET>HELP 



(help display) 



DENVER: : NET>CONTINUE 
RUN $DIRECTORY 



(DIRECTORY display for user 
at node BOSTON) 



3.2.2 CTRL/P Command 

The CTRL/P command is used to pass on a Control-P character to the remote 
node. This is useful when you are running NET at one remote node to con- 
nect to yet another node. 

Example: 

Consider a network having three DECnet/E nodes named DENVER, BOS- 
TON, and TULSA, with BOSTON as the central node. A user at node DEN- 
VER runs NET as follows: 

RUN $NET 

Node Name? BOSTON :: HELLO 

Connection established to RSTS/E Node BOSTON 

RSTS y7.1 Timesharing Job 31 KB33 15-Au3-81 8:00AM 

«2/21B 

Password: (notechoed) 

Ready 
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RUN *NET 

Node Name? TULSA: :HELLO 

Connection established to RSTS/E Node TULSA 

RSTS y7.1 TifttesharinS Job 31 KB33 15-AuS-Bl SsOlAM 

« 1/150 

Passwords (not echoed) 



Ready 



RUN $ODT 

» "P 

DENVER: :NET>CTRL/P 

BOSTON: :NET>ODT 

-P 

DENVER: :NET>ODT 



(TULSA'S ODT waiting for input) 



In this example, the user runs NET at the local node (DENVER) and estab- 
lishes a connection with node BOSTON. At node BOSTON, the user again 
runs NET, establishes a connection with node TULSA, and runs ODT at 
TULSA. 

When ODT displays its prompt, the user types a CTRL/P combination fol- 
lowed by a RETURN, escaping to the local NET's command level. The user 
then types the command CTRL/P, which sends a Control-P character to node 
BOSTON, causing BOSTON'S NET to display its "NET>" prompt. The user 
types ODT, telling BOSTON'S NET to send information to TULSA in the 
single-character mode. The local NET must still be told to send information 
in ODT mode, so the user again types a CTRL/P combination followed by a 
RETURN, escaping to the local NET's command level. The user then types 
the ODT command and is then ready to type commands to the ODT running 
at TULSA. 

NOTE 

Note that this command consists of the actual character 
string "CTRL/P" rather than the CTRL and P key 
combination. 



3.2.3 EXIT Command 

There are two ways to terminate the NET program. You can simply log out 
at the remote node, or you can use the EXIT command. The EXIT command 
severs the connection with the remote node. NPKDVR at the remote node 
automatically kills the job to which the user is connected. NET displays the 
following message: 

Link to Node nodename disconnected 

This message is followed by two bell characters (an audible noise at your ter- 
minal). NET then exits. 
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Example: 



RUN $NET 

Node Name? BOSTON: : 

Conneotiorf established ta RSTS/E Node BOSTON 

HELLO 

RSTS y7.1 Tiwesharins Job 31 KB33 15-Au3-81 8:00AM 

#2/218 

Password: (not echoed) 



Ready (node BOSTON'S Ready prompt) 



RUN $NET 

Node Name? TULSA: :HELLD 

Connection established to RSTS/E Node TULSA 

RSTS y7.1 TimesharinS Job 22 KB17 15-AuS-81 g:01AM 

«2 ,120 

Password: (not echoed) 



Ready (node TULSA's Ready prompt) 

RUN $SYSTAT 

(systat display) 

Ready (node TULSA's Ready prompt) 

BYE/F 

LinK to node TULSA disconnected 

Ready (node BOSTON'S Ready prompt) 



"P 

DENVER: !NET>EXIT 

LinK to node BOSTON disconnected 



Ready (node DENVER'S Ready prompt) 

In this example, the user simply logs off at node TULSA and uses the EXIT 
command to break the link to node BOSTON. 
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3.2.4 HELP Command 

If you type HELP in response to the "NET>" prompt, you will get a help dis- 
play at the terminal. After the help information is displayed, NET displays 
another prompt and you can type another NET command. 

Example: 

RUN $NET 

NET M2.0 RSTS U7 . 1 DECnet Svstew 

Node name? BOSTON : :HELLD 

Connection established to RSTS/E Node BOSTON 

RSTS y7.1 TimesharinS Job 25 KB27 14-Au3-81 10:23AM 

«2/218 

Passwords (not echoed) 



Ready 



(work at node BOSTON) 



-P 

DENVER: :NET>HELP 



(help display) 



DENVER: sNET> 



In the preceding example, the user runs NET at the local node (DENVER), 
requesting a connection to node BOSTON. After the connection is made, the 
user types a standard log-in sequence, the RSTS system at BOSTON dis- 
plays its identifying line and "Ready" prompt, and the user does whatever 
work there he wishes. He then types CTRL/P followed by RETURN to 
return to the local NET program to display the HELP text. After the dis- 
play, NET displays a prompt for another command. 



3.2.5 NORMAL Command 

The NORMAL command is used to stop the single-character input requested 
by the ODT command. It should be used immediately after exiting from a 
program that needs this kind of input. 
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Example: 

(ODT processing at remote node) 



Ready 



DENVER: :NET>NORMAL 



(continue work at node BOSTON) 



In the preceding example, the user terminates ODT at node BOSTON by 
typing CTRL/Z (displayed as Z on the terminal), and the BOSTON RSTS/E 
system displays its "Ready" prompt. The user then types CTRL/P to return 
to the local NET program at node DENVER and NET displays its "NET>" 
prompt. (It is not necessary to type the RETURN key after CTRL/P in this 
case. Since the NET program is forwarding each character as it is typed, it 
recognizes the CTRL/P immediately.) The user types NORMAL to stop 
ODT-mode transfers and returns to work at node BOSTON. 



3.2.6 ODT Command 

Normally, RSTS/E programs receiving input from terminals accept an 
entire line at a time - a line being a string of characters terminated by a car- 
riage-retum/line-feed combination, an escape character, and so forth. A few 
programs, such as ODT (Octal Debugging Tool), do not wait for an entire 
line but process characters as they are typed. When you run such a program 
at the remote node, you must first issue the ODT command to the NET pro- 
gram at the local node. NET will then forward characters to the remote node 
as you type them. 

NOTE 

Using this feature places a heavy load on the network since 
DECnet must now send many more messages over the link 
than it would normally. ODT mode should be used with 
discretion. 

Example: 

NET BOSTON: :HELLO 

Connection established to RSTS/E Node BOSTON 

RSTS y?.! Timesharins Job 31 KB33 IS-AuS-Sl 8:00AM 

«2/Z18 

Password! (not echoed) 

Ready 
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RUN $DDT 

DENVER:: NET >ODT 
210/ 1077 



In the preceding example, the user runs NET as a CCL command, request- 
ing a connection to node BOSTON. The string "HELLO" is given as part of 
the command Une. Once the connection is accepted, the RSTS/E system dis- 
plays its normal prompt for a project-programmer number and the user pro- 
ceeds with logging in. The user then runs ODT at node BOSTON and when 
ODT prints its pound sign prompt for input, the user types the CTRL/P com- 
bination followed by RETURN to return to the NET command level at the 
local node (DENVER). NET responds with its "NET>" prompt and the user 
types ODT. NET processes the command and returns the user to the remote 
node. (ODT was waiting for input.) The user t3^es an ODT command and 
processing continues as normal. 



3.3 NET Error Messages 

?Connect Failure - Invalid node name nodename 

The node name given in response to the "Node name?" prompt is not 
valid. There is no such node in the network. Run NET again, specifying a 
valid node name. 

?Connect Failure - Node shutting down 

The node requested is scheduled for shutdown. No new logical links can 
be established to the node. Try again later. 

?Connect Failure - Too many linlcs to node nodename 

Network traffic to node nodename is too heavy at the moment to estab- 
lish another logical link. Try again later. 

?Connect Reject - NSP reason code = n 

The remote node rejected NET's request for a logical link. NSP reason 
codes are given in Appendix B. 

Illegal Command 

The command you typed in response to a "NET>" prompt is not one of 
those recognized by the NET utility. Type HELP to see a display of valid 
commands. 



NET: Network Command Terminal Utility 3-9 



Chapter 4 

NFT: Network File Transfer Utility 



As the name implies, the main function of the Network File Transfer utility 
(NFT) is to move files from one node to another (see Figure 4-1). You can 
run NFT from a terminal to perform the following functions: 

• Copy files from a storage device at one node to a storage device or output 
device at another node. 

• Copy and append one or more files stored at one node to a file stored at 
another node. 

• Copy and submit a command file stored at one node to another node's 
batch processor or indirect command interpreter for execution. On 
RSTS/E nodes, such files are submitted to the batch processor. 

• Execute an existing command file at a remote node. 

• Delete files stored on a disk at a remote node. 

• Copy and spool print files from one node to another node's printer 

• Obtain a directory listing of files stored on disk at a remote node. 



NOTE 

Even though NFT is written to conform to the Data Access 
Protocol (DAP), Version 5.6, it still supports only the execu- 
table bit during file transfers; file protection codes are not 
passed. Thus, files created as a result of NFT commands 
have a protection code of either <60> or <124>, depending 
on the presence of the executable bit. 



4-1 



RUN $NFT 

NFT>COPY DALLAS::NEW.BAS=BOSTON::MY.BAS 



NODE: 


BOSTON 


PPN: 


120,123 


PASSWORD: 


(not echoed) 


ACCOUNT: 


(none needed) 


NODE: 


DALLAS 


PPN: 


104,160 


PASSWORD: 


(not echoed) 


ACCOUNT: 


(none needed) 


NFT> 






BOSTON 



NFT provides file protection by 
prompting for log-in information 
for remote nodes. 



Figure 4-1 NFT Transfers Files to, from, and between Remote Nodes 
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4.1 Background 



It is easier to understand what NFT does by beginning with a brief descrip- 
tion of how the file transfer capability is implemented in DECnet/E. 

The features listed in the introduction to this chapter are actually provided 
by three software modules - NFT, the File Access Listener (FAL), and the 
Record Management Services (RMS). 

NFT establishes a logical link with a FAL program at the remote node. It 
then accepts commands typed by the local user and transmits them to FAL. 
The FAL program, a part of DECnet, does whatever is necessary on its end 
to execute the commands. NFT and FAL communicate with each other in a 
language defined by the Data Access Protocol (DAP) for DECnet in general. 
Thus, even though the user commands can be different for various DECnet 
implementations of NFT, all DECnet systems having NFT and FAL can 
communicate to do file handling. 

RMS is a file service feature used by NFT and FAL at DECnet/E nodes to 
execute input and output to the local I/O devices. This is of interest mainly 
because non-RSTS/E nodes can use other means to do their local file I/O and 
can require some of the special switches described in Section 4.5. These 
switches ensure that files transferred between nodes with different oper- 
ating systems and file systems are transferred in a usable format. Figure 
4-2 illustrates the interaction between NFT, FAL, and RMS at two DEC- 
net/E nodes. 



OlSVt 



USER RUNS 
NFT 




RMS 


NFT CONNECTS WITH REMOTE FAL 


RMS ' 








' 


NFT 


FAL 


THEY COMMUNICATE ACCORDING 
TO DAP PROTOCOL 











0|S^ 



NFT USES 
RMS TO DO 
LOCAL I/O 



FAL USES 
RMS TO DO 
LOCAL I/O 



Figure 4-2 At DECnet/E Nodes, NFT, FAL, and RMS Work Together to 
Allow File Operations 
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4.2 Running NFT 

You can run NFT from any terminal in a DECnet/E system by typing: 

RUN$NFT 

Or, if NFT has been installed by the system manager as a Concise Command 
Language (CCL) command, you can simply type: 

NFT 

In either case, NFT responds with the prompt NFT> and will accept one 
command per line until CTRL/Z or "EXIT" is typed in response to a prompt: 

NFT> command-1 
NFT> command-2 



NFT> command-n 
NFT> Z 

If NFT has been installed as a CCL command and you want to use only one 
NFT command, you can type NFT and the command on one line, as follows: 

NFT command 

NFT executes the command and immediately returns control to the RSTS/E 
monitor. 

NOTE 

If you are running under the DCL Run-Time System, the 
NFT functions can be invoked by issuing the appropriate 
DCL command (e.g., COPY, DELETE, PRINT, etc.). Since 
the syntax of these DCL commands differs significantly 
from the NFT commands described in this chapter, refer to 
the RSTS/E DCL Usefs Guide for details on using the DCL 
commands. 

To protect files from unauthorized use or destruction, an NFT user must 
supply log-in information for any node referred to in a command. There are 
five methods for supplying this information: 

1. You can use the NETACT utility to provide the information in a file 
that NFT can use each time it is run (see Appendix C). 

2. You can use the NODESPECIFICATION command (see Section 
4.4.7). 

3. You can supply the information as an extension of the remote node 
specification (see Section 4.3.1). 

4. You can use the /IDENTIFY switch to request that NFT prompt for 
the information on a one-time basis (see Section 4.5.8). 
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5. Or, you can simply do nothing and force NFT to prompt for the infor- 
mation. (NFT will prompt you if you refer to a remote node in a com- 
mand and have not specified the log-in information in any other 
fashion.) 

In three of these cases (NETACT file, NODESPECIFICATION command, 
and NFT prompting), once log-in information is specified for a particular 
node, it is used throughout the NFT run each time that node is referenced, 
unless it is changed, overridden, or rejected by the remote node. In the other 
two cases (node name extension and the /IDENTIFY switch), the informa- 
tion is used to override the existing log-in information for one command 
only. 

However specified, NFT uses the log-in information to gain access to the 
remote file system before executing any command affecting a file at a remote 
node. If the information given is valid, you can access any files that you 
could when directly logged in to the remote system under the specified 
account. 



4.3 General Format of NFT Commands 

A DECnet/E NFT command consists of a command keyword (defining an 
action) and variable parameters (defining the nodes and files involved in the 
action). In addition, switches can be used when necessary to further define 
the action to be performed. For example: 

COPY DENUER: : F ILE . LST/SU=D ALIAS : sMYFILE.TXT 

COPY is the command keyword, indicating that the file on the right of the 
equal sign (MYFILE.TXT at node DALLAS) is to be copied to the node 
named DENVER under the name FILE.LST. The /SU switch indicates that 
if a file already exists on node DENVER called FILE.LST, it will be super- 
seded by the file being transferred. 

Command and switch keywords can be abbreviated. In general, the first two 
characters of the keyword are all that is necessary. Some switches, however, 
require four characters to identify the switch. For example: /NOHEADING, 
/NOSUPERSEDE, and /NODELETE. 

The commands and switches recognized by the DECnet/E implementation of 
NFT are described in Sections 4.4 and 4.5. Most of the user-supplied argu- 
ments identify files to be manipulated by NFT. The following general com- 
ments apply. 

4.3.1 Node Names 

DECnet/E NFT can be used to manipulate files to, from, and between remote 
nodes. NFT will also work with files at the local node, although it is gener- 
ally more efficient to use the RSTS/E utilities designed to manipulate files at 
the local node. 
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The network shown in Figure 4-3 will be used as an example throughout 
this chapter. To illustrate file transfers among DECnet nodes with different 
operating systems, BOSTON and DENVER are DECnet/E nodes (RSTS/E 
operating system); DALLAS is a DECnet/llM node (RSX-llM operating 
system); and MIAMI is a DECnet/RT node (RT-11 operating system). 




DECnet/E 
NODE: BOSTON 



DECnet/RT 
NODE: MIAMI 



Figure 4-3 Sample Network Showing Transfers between Nodes with 
DECnet/E NFT 

To identify the remote node where a particular file is located or to which it is 
to be moved, the 1- to 6-character, alphanumeric node name is given. The 
node name must contain at least one letter and is followed by two colons (::) 
to separate it from the file specification. (Names of currently active nodes in 
the network can be determined with the NCP command SHOW ACTIVE 
NODES, described in the DECnet/E System Manager's Guide.) If the local 
node name is specified in an NFT command, FAL is run at the local node. 

As mentioned in Section 4.3.1, the log-in information required by NFT to 
access files at the remote node can be specified as an extension of the node 
name. If included, this information must be in the following format: 

nodename "[user-id] [password] [account-id]":: 

The parameters user-id, password, and account-id are the same as described 
with the NODESPECIFICATION command (see Section 4.4.7). They are 
separated by either a space or a horizontal tab character and are enclosed in 
double quotes. 

As with quoted strings (see Section 4.3.4), NFT simply removes the quotes 
and passes the characters they enclose to the remote system without exam- 
ination. In some circumstances, this means that the accounting information 
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is processed differently than if it had been specified with the NODESPECI- 
FICATION command, through the NETACT program, or with prompting. 
For example, consider the case where the remote system is running the 
VAXA/^MS operating system. Since VMS does not permit nonoctal user iden- 
tification codes, NFT ordinarily converts the specified user-id to the VMS- 
compatible octal equivalent. However, if the log-in information is included 
with the node name, enclosed in quotes, no conversion is done and errors 
may result. 



4.3.2 File Specifications 

The way in which files are identified depends on the operating system at the 
node where the file is located. For file specification formats used with non- 
RSTS/E nodes, consult the documentation for the appropriate operating 
system. 

For files at RSTS/E nodes, the file specification is a subset of the full RSTS/E 
file specification. The elements used (device, project-programmer number, 
file name, and type) follow the rules for RSTS/E file specification. 

dev : [ppn\filename. typ 

The dev item is a device designation. If this is omitted, the system disk (SY:) 
is assumed. 

Although you can refer to specific devices at the local or remote nodes, you 
are responsible for seeing that tapes are mounted and positioned properly, 
and so forth. If a device is busy, NFT will return an error message. You can 
use the ASSIGN and DEASSIGN commands at the local node to reserve 
local devices. 

NOTE 

It is currently more practical to use NFT to move files 
between disk structures (either public or normally mounted 
private disks) at each node than to request transfer to or 
from another type of device. For example, suppose you are 
using NFT to transfer a file to the local node for transfer to 
a magnetic tape. Use NFT to transfer the file to public disk 
and then use PIP to transfer the file to magtape. (The 
RSTS/E System Usefs Guide describes how to use PIP.) 

The ppn is the project-programmer number identifying the directory in 
which the file is located - for example, [100,201]. (On some DIGITAL sys- 
tems, the ppn is called a user identification code, or UIC.) If omitted, the ppn 
is assumed to be the user ID specified during the NFT log-in sequence (with 
the NODESPECIFICATION command, NFT's prompting, or through the 
NETACT utility) for the node being referenced. Access to another ppn 
depends on the user's privilege at the node in question. (Note that some 
DIGITAL systems permit alphanumeric directory names to be assigned 
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equivalent to the project-programmer number. If the remote system permits 
such names, they can be used in the file specification.) 

NOTE 

If a ppn is given, the square brackets (or parentheses) must 
be used. 

The filename.typ is the file name and type. For files on RSTS/E nodes, the 
filename can be up to 6 alphanumeric characters, and typ can be up to 3 
alphanumeric characters. If a command accepts both an input and an output 
file specification and the output specification is omitted, NFT will default 
the output file specification to that supplied for the input file. If typ is 
omitted, NFT does not supply a default. 

4.3.3 Wildcards 

NFT permits wildcard characters in file specifications, allowing the user to 
select a set of files for sequential file retrieval, file deletion, file spooling, 
directory listings, or command file execution. The format of the wildcard 
syntax depends on the capabilities of the remote node to process the file 
specification. 

In an input file specification, any valid wildcard that is acceptable to the 
remote or local system is acceptable. For example, if the remote system is a 
RSTS/E system, an input file specification of A?????.LST selects as input all 
those files with an type of .LST and a file name beginning with the letter A. 
The ppn in an input specification can be entered as either [*], for named 
directories, or [*,*], for numeric project-programmer numbers. 

The only valid wildcard character supported for output, however, is the 
asterisk (*). An asterisk can be used to replace one entity in the file specifi- 
cation. Thus, "A?????.LST" in the previous example is invalid as an output 
file specification but "*.LST" is permitted. 

When wildcards appear in the output file specification of certain commands, 
names are duplicated on a one-to-one basis during the operation as specified 
by the wildcards. For example, consider the following COPY commands: 

COPY *.DAT = DALLAS: : [ COWBOY ]#. LST 

COPY *.DAT = DENyER: :C1 »34 ]F I LEA . LST , C 3 , 1 23F ILEB . LST 

On receiving the first command, NFT copies every file from the directory 
COWBOY on node DALLAS with the type .LST to a file on the local node in 
the current directory with the same file name but with a type of .DAT. 

The second command causes NFT to copy FILEA.LST from directory [1,34] 
on node DENVER to FILEA.DAT in the current directory on the local node 
and FILEB.LST from directory [3,12] on node DENVER to FILEB.DAT, also 
in the current directory on the local node. 
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In most cases, when the input file specification contains wildcards but the 
output file specification contains none, the input files are all concatenated 
into the one output file. For example, consider the first example shown pre- 
viously, slightly modified: 

COPY MASTER. DAT=DALLAS: : CCOWBOY ]* . LST 

This command causes NFT to copy every file with the type .LST from direc- 
tory COWBOY on node DALLAS to a single file MASTER.DAT in the cur- 
rent directory on the local node. Each of the files located with the type .LST 
is appended, in sequence, into a single output file named MASTER.DAT. 

In this circumstance, as with the APPEND command (see Section 4.4.1) and 
the /APPEND switch (see Section 4.5.1), the user must be aware of the attri- 
butes of the individual source files. Concatenating an image file with an 
ASCII file, for example, can have unpredictable results, depending on how 
the final destination file is to be used; an error message may or may not be 
generated. Thus, when using wildcards in the source file specification in this 
fashion, it can be useful to apply the /INQUIRY switch (see Section 4.5.10). 
As each input file is located, the user can then make a decision as to whether 
or not the file should be included in the operation. 



4.3.4 Quoted strings 

Quote characters can be used in commands to tell the local NFT not to exam- 
ine the characters enclosed by the quotes. In general, when NFT encounters 
paired double quotes ("text") or single quotes ('text'), it removes the quotes 
and passes the characters they enclose to the remote system without exam- 
ination. This is useful when it is necessary to include characters in a file 
specification for a remote, non-RSTS system that the local NFT recognizes 
in its own analysis of a command. 

For example, suppose you want to copy a file to a DECnet/RT node and you 
want to use the RT-11 file system's switch for allocating a specific amount of 
storage space for the file. This switch is of the form fB:n. To prevent the local 
NFT from interpretting the slash and trying to parse the switch as one of its 
own (Section 4.5), you can enclose the file specification in quotes: 

COPY RTNODE: : "FILE . LST/ B : 200 " = LOCF IL . 1 

The local (RSTS/E) NFT also treats pairs of square brackets - [ ] - paren- 
theses - ( ) - and angle brackets - < > - in a similar manner. It does not 
remove these pairs, however, but passes them on, along with the characters 
they enclose, without examination. These characters can be used for access 
to either the local or a remote node. (At a DECnet/E node, local or remote, 
the characters enclosed would be passed on directly to RMS.) 
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4.4 NFT Commands 



There are twelve NFT commands available. Each command is discussed in 
detail in the following subsections. The commands available are: 



APPEND 

COPY 

DELETE 

DIRECTORY 

EXIT 

HELP 

NODESPECIFICATION 

PRINT 

SUBMIT 

TYPE 
VERSION 



Append file(s) from one node to a file on 
another. 

Copy file(s) from one node to another. 

Delete file(s) at a remote node. 

Obtain a directory listing of files at a remote 
node. 

Exit from NFT. 

Obtain instruction information. 

Enter remote node log-in information. 

Spool file(s) from one node to the line printer of 
another node. 

Submit file(s) from one node for execution on 
another node. 

Display file(s) on the terminal console. 

Display the local NFT or remote FAL version 
number. 
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4.4.1 APPEND Command 

The APPEND command transfers one or more files from one node to 
another, appending them to the end of an existing file at the target node. 

NOTE 

When invoking this command, the user should be aware of 
the attributes of the files to be appended and ensure that 
the files are compatible. Appending a variable-length 
record file to one with fixed-length records, for example, can 
have unpredictable results. An error message may or may 
not be output. 

Command Format: 

APPEND [dstnode::]outfile = [srcnode::]filel[,...,filen] 

Parameter Descriptions: 
dstnode 

The dstnode is the name of the node containing the file to which the other 
files are to be appended. If omitted, the local node is assumed. 

outfile 

The outfile is the file specification of the existing file to which the others are 
to be appended. 



The equal sign separates the destination and source specifications. 
srcnode 

The srcnode is the name of the node from which the files are to be copied. If 
omitted, the local node is assumed. 

filel,... 

These are the file specifications for the files to be transferred and appended. 
They will be appended to the end of outfile, in the order specified. 

Example: 

NFT> APPEND DALLAS :: ACCT * BAS = AACCT . BAS .BACCT . BAS 

In this example, the files AACCT.BAS and BACCT.BAS are copied from the 
local node and appended to the file ACCT.BAS at node DALLAS (Figure 

4-4). 
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APPEND DALLAS::ACCT.BAS = AACCT.BAS, BACCT.BAS 




BOSTON 



MIAMI 



Figure 4-4 Example of the APPEND Command 
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4.4.2 COPY Command 

The COPY command copies one or more files from one node to one or more 
files at another node. The files are not deleted at the source node. COPY is 
the default command for NFT; the command keyword COPY can be omitted 
entirely. 

Command Format: 

[COPY][dstnode::][outfile][ = ][srcnode::]filel[,...,filen] 

Parameter Descriptions: 
dstnode 

The dstnode is the name of the destination node to which the file(s) are to be 
transferred. If omitted, the local node is assumed. 

outfile 

The outfile is the file specification to be given to the transferred file(s) at the 
destination node. If no wildcards are used, the input files are concatenated 
in the order specified to form outfile. If wildcards are used, each output file 
created at the destination node will have the outfile specification, as speci- 
fied by the wildcards in the input file names. 



The equal sign separates the destination and source specifications. 
srcnode 

The srcnode is the name of the source node from which the file(s) are to be 
copied. If omitted, the local node is assumed. 

filel,... 

These are the file specifications for the files stored at the source node that 
are to be copied. 

The equal sign is only required if a dstnode or outfile specification is 
included in the command. If all three items are omitted, the input files 
ifilen) will be copied to the user's keyboard console. If dstnode and outfile are 
omitted but the equal sign is not, the output file is assumed to be "*.*". 

Example: 

NFT> AFIL.BAS=DDSTON: :AFIL.BAS 

NFT> BFIL.BAS=BOSTON: :BFIL,BfiS 

NFT> CO DK1:MYFILE.BAB=B0ST0N: :AFIL.BAS.BFIL.BAS 

NFT> COPY DALLAS: :NEWFIL.BAS = BOSTON: :AFIL.BAStBFIL.BAS 
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In all these examples, files AFIL.BAS and BFIL.BAS are copied from the 
node named BOSTON (see Figure 4-5). In the first two commands, the files 
are copied to the local node's system disk as separate files named AFIL.BAS 
and BFIL.BAS, the same names they had at node BOSTON. In the third 
command, they are copied and concatenated to form a file named 
MYFILE.BAS on disk DKl at the local node. In the fourth command, they 
are copied to form a file named NEWFIL.BAS on the public disk at node 
DALLAS. 

O AFIL.BAS = BOSTON::AFIL.BAS 
Q BFIL.BAS = BOSTON :;BFILBAS 

O COPY DK1-.MYFI LE.BAS = BOSTON. AFI L.BAS.BFI L.BAS 

O COPYDALLAS::NEWFIL.BAS = BOSTON::AFIL.BAS.BFIL.BAS 




Figure 4-5 Examples of the COPY Command 
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4.4.3 DELETE Command 

The DELETE command deletes the specified files. These files must exist on 
disk; tape files cannot be deleted with this command. 

Command Format: 

DEL'ETE[dstnode::]filel[,...,filen] 

Parameter Descriptions: 

dstnode 

The dstnode is the name of the remote node at which the files to be deleted 
are located. If omitted, the local node is assumed. 

filel,... 

These are the file specifications for those files to be deleted. These files must 
reside on disk; no tape file deletions are allowed. 

Example: 

NFT> DELETE M I AM I : : F IL . RNO f B INFIL » SAt,' tRM . BAS 

The files FIL.RNO, BINFIL.SAV, and RM.BAS are deleted from the public 
disk at node MIAMI (see Figure 4-6). 

DELETE MIAMI:: FIL. RNO,BINFIL.SAV,RM.BAS 




BOSTON 



Figure 4-6 Example of the DELETE Command 
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4.4.4 DIRECTORY Command 

The DIRECTORY command displays a directory listing of files located at a 
remote node. 

Command Format: 

DIRECTORY [dstnode::][outfile][ = ][srcnode::]filel[,...,filen] 

Parameter Descriptions: 

dstnode 

The dstnode is the name of the destination node on which the directory list- 
ing is to be created. If omitted, the local node is assumed. 

outfile 

The outfile is the specification of the file to receive the output listing. If it is 
omitted, the listing is output to the console on the destination node. If the 
file currently exists, its contents are overwritten unless the /APPEND 
switch is used (see Section 4.5.1). 



The equal sign separates the destination and source specifications. 

srcnode 

The srcnode is the name of the node at which the files to be listed are located. 

fllel,... 

These are the specifications of the files to be listed. They must exist at the 
source node. 

The equal sign is only required if a dstnode or outfile specification is 
included in the command. If all three items are omitted, the directory listing 
is output to the user's console. 

Example: 

DIRECT DENMER: : [7>214]*,# 

A complete listing of all files in account [7,214] on the system disk of node 
DENVER is displayed at the local console. 
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DIRECT DENVER: : [7,214] 




LISTING OF ALL 
FILES IN [7,214] ON 
NODE DENVER OUTPUT 
TO LOCAL CONSOLE 



Figure 4-7 Example of the DIRECTORY Command 
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4.4.5 EXIT Command 

The EXIT command is used to terminate execution of NFT. It is equivalent 
to typing CTRL/Z. 

Command Format: 

EXIT 
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4.4.6 HELP Command 

The HELP command is used to display information about the commands 
and switches available with DECnet/E NFT. 

Command Format: 

HELP COMMANDS 
SWITCHES 

If neither COMMANDS or SWITCHES is specified, both sets of information 
are displayed. 

The HELP command does not involve network access. 
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4.4.7 NODESPECIFICATION Command 

The NODESPECIFICATION command allows you to enter or change the 
log-in information required to estabHsh you as a valid user at a remote node. 
This information is kept and used in subsequent references to the node for 
this particular execution of NFT. 

You do not have to use this command to define initial log-in values, how- 
ever. NFT prompts for log-in information each time you refer to a node for 
which you have not yet given any log-in information. This log-in informa- 
tion is also kept and used for the entire run or until it is changed with 
another NODESPECIFICATION command. 

(Log-in information can be altered on a one-time basis for a single command 
with either the node name extension (see Section 4.3.1) or with the 
/IDENTIFY switch (see Section 4.5.8).) 

Command Format: 

NODESPECIFICATION [nodename::] 

Parameter Descriptions: 

nodename 

The nodename is the name of the node at which you wish to be validated as 
an established user. If omitted, NFT lists the nodes you have already speci- 
fied, if any, along with the log-in information you gave for the nodes. 

If nodename is given, NFT prompts for log-in information, first redisplaying 
the node requested. 

Node: nodename 

User: ppn 

Password: password 

Account: account-id 

After each prompt, you t3T)e the appropriate information. The ppn is the 
project-programmer number (sometimes referred to as a user identification 
code or UIC) used for logging in at the remote node. It can be up to 16 char- 
acters long. If the remote node permits alphanumeric named directories in 
addition to or in place of numeric project-programmer numbers, you can 
specify the ppn in that form. 

The password is a 1- to 8-character string; the account-id can be up to 16 
characters. If a password is entered, it is not echoed at the terminal. 

If a particular item, such as the account-id, is not used for log-in at the 
remote node, you can omit it by entering only a carriage return in response 
to the prompt. 
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Example: 



NFT> NO BOSTON: : 

Node: BOSTON 

Users 120 J 4 

Passwo rd: 

Account; Ret 

NFT> 



NFT, having accepted the log-in information, is ready to accept another 
command. Note that that password, although entered, did not echo on the 
terminal. 
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4.4.8 PRINT Command 

The PRINT command copies one or more files from disk at one node to one or 
more temporary files at another node for input to the line printer spooler. 
After the temporary file is printed, it is deleted from the destination node 
unless the /NODELETE switch is used. The destination node must, of 
course, have a line printer spooler. 

Command Format: 

PRINT [dstnode::][outfile][ = ][srcnode::]filel[,...,filen] 

Parameter Descriptions: 

dstnode 

The dstnode is the name of the node to which the files are to be copied, 
printed, and deleted. If the node name is omitted, the local node is assumed. 

outfile 

The outfile is the name of the temporary file at dstnode. If this specification 
contains no wildcards, the input files will be concatentated into a single out- 
put file and printed. If wildcards are specified, multiple temporary files will 
be created and printed at the destination node, with file names created 
according to the wildcards in the input specification. If the destination is a 
RSTS/E node, outfile must be a disk file. 



The equal sign separates the destination and source specifications. 
srcnode 

The srcnode is the name of the node from which the files are to be copied. If 
omitted, the local node is assumed. 

fUel,... 

These are the files to be copied from srcnode and printed. These files must be 
on disk. 

The equal sign is only required if the dstnode or outfile is specified. If both 
are omitted, the input files will be queued to the line printer spooler at the 
source node. In this case, the file is not deleted after printing unless the 
/DELETE switch is used (see Section 4.5.6). 

Example: 

NFT> PRINT DENVER: :TEKT.DOC=MIAMI: :BOOK?. DOC 

All files at node MIAMI with file names beginning with BOOK and with the 
type .DOC are concatenated and copied to a temporary file named 
TEXT.DOC at node DENVER. File TEXT.DOC is then printed and deleted 
(see Figure 4-8). 
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PRINT MIAMI;: TEXT.DOC = BOSTON:: B00K7.DOC 



COPIED AND SUBMITTED 
TO SPOOLER, LISTED, 
AND DELETED. 



BOSTON 




Figure 4-8 Example of the PRINT Command 
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4.4.9 SUBMIT Command 

The SUBMIT command copies one or more files from one node to one or more 
temporary files at another node for execution. After execution, the command 
file is deleted from the destination node unless the /NODELETE switch is 
used. The destination node must be able to execute command files and the 
files must be in the proper format for execution at that node. For RSTS/E 
nodes, the files are submitted to BATCH, the batch processor. (The RSTS/E 
System User's Guide discusses the command file format for BATCH.) 

Command Format: 

SUBMIT ldstnode::][outfile][ = ][srcnode::]filel[,...,filen] 

Parameter Descriptions: 

dstnode 

The dstnode is the name of the node to which the command files are to be 
copied, executed, and deleted. If the node name is omitted, the local node is 
assumed. 

outfile 

The outfile is the name of the temporary file to be created at dstnode. If this 
specification contains no wildcards, the input files will be concatentated into 
a single output file and submitted for execution. If wildcards are specified, 
multiple temporary files will be created and submitted at the destination 
node, with file names created according to the wildcards in the input 
specification. 



The equal sign separates the destination and source specifications. 
srcnode 

The scrnode is the name of the node from which the files are to be retrieved. 
If omitted, the local node is assumed. 

filel,... 

These are files to be copied from srcnode and executed. 

3 The equal sign is only required if dstnode or outfile is specified. If both are 
omitted, the input file(s) already existing at the source node are submitted 
to the batch processor on that node. In this circumstance, the files are not 
deleted after execution unless the /DELETE switch is used (see Section 
4.5.6). 

Example: 

NFT> SUBMIT BOSTON :: RBAT . CTL=# . CTL 

All files at the local node with a type of .CTL are copied into a temporary file 
called RBAT.CTL at node BOSTON, executed, and deleted (see Figure 4-9). 
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SUBMIT BOSTON:: RBAT,CTL=*,CTL 




BOSTON 




COPIED AND 
SUBMITTED 
TO BATCH, 
EXECUTED 
AND DELETED 



Figure 4-9 Example of the SUBMIT Command 
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4.4.10 TYPE Command 

The TYPE command displays the input files from the source node on the 
user's terminal display. It is equivalent to the COPY command when every- 
thing to the left of (and including) the equal sign is omitted. 

Command Format: 

TYPE [srcm}de::]filel[,...,filen] 
Parameter Descriptions: 
scrnode 

The srcnode is the name of the source node from which the file(s) are to be 
retrieved. If omitted, the local node is assumed. 

file1,... 

These are the file specifications for the files stored at the source node that 
are to be typed on the user's console. 

Example: 

NFT> TY DALLAS: :DAILY, SUM 

In this example, the file DAILY.SUM is retrieved from the public disk on 
remote node DALLAS and typed out on the user's keyboard console (Figure 
4-10). 




MIAMI 



Figure 4-10 Example of the TYPE Command 
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4.4.1 1 VERSION Command 

The VERSION command is used to display the version numbers of the local 
DECnet/E NET program or the remote FAL program, as well as the version 
number of the Data Access Protocol (DAP) being used. 

Command Format: 

VERSION [srcnode::] 

Parameter Descriptions: 

srcnode 

The srcnode is the name of the node at which the version number of FAL is 
to be examined. If this parameter is omitted, the version number of the local 
NFT is displayed, along with the version number of DAP. 



NFT: Network File Transfer Utility 4-27 



4.5 NFT Switches 



The switches hsted below can be used in NFT commands. Most of these 
switches apply only to certain commands and some can apply only to the 
source or destination file specification. In general, a switch is appended to a 
file specification and it applies to that file only. More than one switch can be 
used as long as they are logically consistent. 



/APPEND 
/ASCII 
/BLOCK 
/BRIEF 



Append input file(s) to output file. 
Data being transferred is ASCII 7-bit data. 
Transfer image data in 512-byte blocks. 
Grenerate an abbreviated directory listing. 



/CONTIGUOUS or /CTG Allocate space contiguously. 



/DELETE 

/FULL 

/IDENTIFY 

/IMAGE 

/INQUIRY 

/LIST 

/LOG 

/MORE or - 

/NATIVE 

/NOCONTIGUOUS 

/NODELETE 

/NOHEADING 

/NOSUPERSEDE 

/POS 

/RWC 

/RWO 

/SUPERSEDE 

/TOTAL 

A^ARLABLE 



Special-case delete for SUBMIT and PRINT 
commands. 

Generate an extended directory listing. 

Have NFT prompt for log-in information. 

Data being transferred in 8-bit data. 

Verify input file before function execution. 

Generate a normal directory listing. 

Output file name after function execution. 

Continue command input on next line. 

Reformat file to stream ASCII. 

Allocate space noncontiguously. 

Do not delete temporary file. 

Generate directory listing with no header. 

Do not supersede an existing file. 

Position magnetic tape to end of volume. 

Rewind magnetic tape on close. 

Rewind magnetic tape on open. 

Supersede an existing file. 

Output directory size only. 

Reformat file to variable format. 
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4.5.1 /APPEND - Append Input to Output 

The /APPEND switch can be applied to the destination file specification in 
the COPY and DIRECTORY commands. When used with the COPY com- 
mand, the effect is equivalent to the APPEND command; the input files are 
appended to the output file. 

NOTE 

When using this switch with the COPY command, the user 
should be aware of the attributes of the files to be appended 
and ensure that the files are compatible. Appending a vari- 
able-length record file to one with fixed-length records, for 
example, can have unpredictable results. An error message 
may or may not be output. 

When used with the DIRECTORY command, applied to an existing output 
file, the resulting directory listing is appended to the specified file rather 
than overwriting it. 

Example: 

NFT> COPY TEXT. DOC/APP = DALLAS: -.BOOK??, DOC 
NFT> DIRECTORY D I RECT , LST/ AP= [ 7 ,2 1 4 ]# . BAS 



4.5.2 /ASCII - Transfer 7-Bit ASCII Data 

This switch is used to indicate that a transmitted file contains 7-bit ASCII 
data. It can be applied to the source file specification of the COPY, TYPE, 
SUBMIT, APPEND, or PRINT commands. 

Example: 

NFT> COPY MIAMI: :MEM0.D0C=[7 ,2ia]N0TES.TXT/ASC 



4.5.3 /BLOCK - Transfer Image Data In 512-Byte Blocks 

This switch is used when transferring image (binary) files with the COPY or 
APPEND commands. It should be applied to the source file specification, and 
causes the files to be transferred in 512-byte blocks. 

Note that the /BLOCK switch is generally only applicable for RSTS to RSTS 
file transfers since other operating systems do not fully support binary block 
transfers. The switch is necessary for non-ASCII files that do not have 
recorded attributes. On RSTS/E systems, such files include compiled 
BASIC-PLUS files (file types = .BAC), record-I/O or virtual array data 
files, and binary files such as those with file types of .OBJ or .SAV. The 
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switch should not be used, however, for files that have record attributes (e.g. 
MAC.TSK object modules). Using the /BLOCK switch results in a BLOCK 
image copy of the file, with the original attributes being lost. Thus, the 
/BLOCK switch should be used only with unattributed files. 

Example: 

NFT> COPY STORBN.BAC=BOSTON: :CDMP.BAC/BL 



NOTE 

The /BLOCK switch is incompatible with and should not be 
used with either the /NATIVE switch (described in Section 
4.5.14) or the /VARIABLE switch (described in Section 
4.5.24). 



4.5.4 /BRIEF - Output a Brief DIRECTORY Listing 

The /BRIEF switch can be used at the end of the DIRECTORY command to 
give a brief directory listing including device, directory, file name, and file 
type. This listing is similar to the listing generated by the RSTS/E PIP 
program. 

Example: 

NFT> DIR QUICK. D1R=MIAMI: : [7,214]*. DOC/BR 



4.5.5 /CONTIGUOUS or /CTG - Allocate Space Contiguously 

This switch can be applied to the destination file specification in the COPY, 
SUBMIT, or PRINT command. It allocates contiguous space for the destina- 
tion file(s). If a contiguous allocation cannot be made, the command will fail. 

Example: 

NFT> COPY DALLAS: :FILE1.TSK/C0=MYFILE.TSK 

In this example, contiguous space is allocated at node DALLAS (an RSX- 
IIM node) for the binary file FILEl.TSK, consisting of the file 
MYFILE.TSK transferred from the local node. 



4.5.6 /DELETE -Delete Files on Close 

This switch can be applied to any file specification in any command. It is 
used to delete the indicated file upon successful completion of the specified 
function. 
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The primary use of this switch applies to the source file specification of the 
SUBMIT or PRINT commands when no destination file specification is sup- 
plied - that is, when the files to be printed or submitted to the batch proc- 
essor already exist at the desired node. With this form of these two 
commands, the files are not automatically deleted since they are, in fact, the 
source files and not temporary destination files. Using the /DELETE switch 
in this case will cause the files to be deleted at the conclusion of the 
operation. 

Example: 

NFT> PRINT ROUGH. DRF/DELETE 



4.5.7 /FULL - Output a Full DIRECTORY Listing 

The /FULL switch can be used at the end of the DIRECTORY command to 
give a directory listing including device, directory, file name, file type, file 
size, protection code, creation date and time, as well as a listing of the sym- 
bolic attributes. This listing is similar to the full directory listing generated 
by the RSTS/E PIP program. 

Example: 

NFT> DIR DALSYS.DIR=DALLAS: :SY:C1 *2]*.#/FULL 



4.5.8 /IDENTIFY - Prompt for Log-in Information 

This switch can be applied once to both the source and destination specifica- 
tions of any command. It causes NFT to prompt for log-in information. The 
information you give in response to this prompting is used only for the cur- 
rent operation. It is not kept for the rest of the NFT execution. After the exe- 
cution of a command with this switch, the log-in information reverts to what 
was previously specified for the node, if any. 

If the /IDENTIFY switch is applied to both the source and destination speci- 
fications, NFT prompts for information for the source node first. A second set 
of prompts is used to obtain information concerning the destination node. 

Example: 

NFT> COPY BOSTON: :FILE1 .TXT/ID=DALLAS: :FILE3.TKTtFILEa.TKT/ID 



Node: 


DALLAS 


User: 


120 tl50 


Passwo rd : 




Account : 




Node: 


BOSTON 


Use r: 


30 ,117 


Passwo rd : 




Account : 
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NFT uses the log-in information to copy the files and then deletes the log-in 
information from its internal records. Previously specified log-in informa- 
tion for BOSTON and DALLAS, if any, is restored for use in subsequent 
commands. Note that the password is not echoed on the keyboard. 



4.5.9 /IMAGE - Transfer 8-Bit Image Data 

This switch is used to indicated that a transmitted file contains 8-bit image 
data. It can be applied to the source file specification of the COPY and 
APPEND commands. 

Example: 

NFT> APPEND DALLAS :: TOTALS . DAT = BOSTON :: CI ,34 ]DA ILY , SUM/ IMAGE 



4.5.10 /INQUIRY- Prompt for Input File Verification 

The /INQUIRY switch can be applied to the source file specification the 
APPEND, COPY, SUBMIT, PRINT, TYPE, and DELETE commands. It is 
used to request that the name of each input file be displayed for verification 
before the file is opened and the indicated function is performed. After the 
name is displayed the user can respond to the prompt with either Y[ES] or 
N[0] to indicate whether the operation should, in fact, be performed on that 
particular file. If a NO response is given, the file is skipped and the next file 
name is displayed. 

Example: 

NFT> DELETE MI AMI : : C 7 ,214 ]* . DOC/ INO 

This switch is especially useful when the destination file specification does 
not contain wildcards and the source files are to be concatenated into one 
file. In this circumstance, if the source files represented by the wildcard 
specification have incompatible attributes, unpredictable results can occur, 
depending on how the final destination file is to be used; an error message 
may or may not be generated. By using the /INQUIRY switch, the user can 
make a decision, on a file by file basis, as to whether or not a file should be 
included in the operation. 



4.5.1 1 /LIST - Output a Normal DIRECTORY Listing 

The /LIST switch can be used at the end of the DIRECTORY command to 
give a directory listing including device, directory, file name, file ts^je, file 
size, protection code, and creation date and time. This listing is similar to 
the directory listing generated by the RSTS/E PIP program. 
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If no switch is appended to the DIRECTORY command, the /LIST switch is 
assumed. 

Example: 

NFT> DIRECT DENMER : : C 100 ,573* . */LIST 



4.5.1 2 /LOG - Log Input File Name on Close 

The /LOG switch can be appHed to the source file specification in the 
APPEND, COPY, SUBMIT, PRINT, TYPE, and DELETE commands. It is 
used to request that the name of each input file be logged to the console after 
the indicated function is performed. This is useful when the input file speci- 
fication contains wildcards. 

Example: 

NFT> COPY B0ST0N::[1 .230]*. # = DENUER::C3, 453*. MAC/LOG 



4.5.1 3 /MORE or - - Continue Command to Next Line 

This switch can be used at the end of a terminal line to indicate that the 
command is to be continued on the next line. NET then prompts for contin- 
uation lines with the characters "MORE>". A CTRL/Z typed in a contin- 
uation line causes the whole command to be deleted and the "NFT>" prompt 
to be displayed. (Otherwise, a CTRL/Z terminates NET and returns control 
to the RSTS/E monitor.) To continue a command to several lines, the 
switches can be used more than once. 

The /MORE switch or hyphen (-) cannot be used when NET is run as a 
single-line command: 

NET command 

Example: 

NFT> DALLAS :: DKO. • C 120 »1 53 ]FILE.RNO = BOSTDN:: [30, 205 ]DK1 /MORE 
MORE> :FILE.RNO.- 
MORE> FILE3.RN0 
NFT> 



4.5.14 /NATIVE - Reformat File to Stream ASCII 

This switch can be applied to the destination file specification in a COPY, 
APPEND, SUBMIT, or PRINT command when the destination node is a 
RSTS/E node. It may also be used in the TYPE command. It converts files 
stored at the source node (in either of two ASCII formats) to stream ASCII 
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files at the destination node. The two source formats are: (1) RMS-11 vari- 
able-length records with implied carriage control, or (2) variable-length 
records with imbedded carriage control characters. This is useful when 
transferring ASCII files from an RSX or VAXA^MS node, that does not proc- 
ess stream ASCII, to a RSTS/E node, that does. 

Example: 

NFT> COPY TEST. MAC/NA=DALLAS! :FIL. MAC 

The /NATIVE switch can also be applied to the source file specification in a 
COPY, TYPE, APPEND, SUBMIT, or PRINT command when the source 
node is either a TOPS20 or an RTll node and the files are to be transferred 
as stream ASCII files to the destination node. The /NATIVE switch is used 
to inform the source node that the file is stream ASCII, so that the source 
node sends it as such across the network. RTll and TOPS20 files do not have 
file attributes recorded as part of the file, so NFT at the source has no way of 
knowing, without the /NATIVE switch, that the file is stream ASCII. 

Example: 

NFT> COPY PROGA.MAC=MIAMI: :PROGA.MAC/NA 



NOTE 

The /NATIVE switch is incompatible with and should not 
be used with the /BLOCK switch, described in Section 4.5.3. 



4.5.1 5 /NOCONTIGUOUS - Allocate Space Noncontiguously 

This switch can be applied to the destination file specification in the COPY, 
SUBMIT, or PRINT command. It allocates noncontiguous space for the des- 
tination file(s). 

Example: 

NFT> COPY DALLAS: :FILE1 .TBK/NOCa=MYFILE.TSK 

In this example, noncontiguous space is allocated at node DALLAS (an 
RSX-llM node) for the binary file FILEl.TSK, consisting of the file 
MYFILE.TSK transferred from the local node. 



4.5.1 6 /NODELETE - Save Temporary Files 

The /NODELETE switch can be applied to the destination file specification 
in a PRINT or SUBMIT command to suppress deletion of the temporary 
file(s) created at the destination node. 
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Example: 

NFT> SUBMIT BOSTON :: RBAT . CTL/NOD=* . CTL 

NFT> PRINT TEXT, DOC/NODELETE=DALLAS: :BOOK??. DOC 



4.5.1 7 /NOHEADING - Output a DIRECTORY Listing with No 
Header 

The /NOHEADING switch can be used at the end of the DIRECTORY com- 
mand to give a listing without the header hne across the top. The directory 
listing includes a complete file specification for each entry: device, project- 
programmer number, file name and file type. This switch is useful in creat- 
ing batch command files. 

Example: 

NFT> DIRECT L IBRY . CTL = DALLAS : : [2 , 1 73]* . BAU/NOHEAD 



4.5.18 /NOSUPERSEDE - Do Not Supersede an Existing File 

This switch can be applied to the destination file specification in a COPY, 
SUBMIT, or PRINT command. If a file already exists at the destination node 
with the same name as that given in the command, the command will fail. 

Normally, when NFT finds that the specified output file name already 
exists, it prompts the user, asking whether the existing file should be super- 
seded. The /NOSUPERSEDE switch disables this automatic feature. This is 
useful in batch command files that cannot handle unexpected prompting for 
user input. 

Example: 

NFT> COPY FILE. LST/NOSU = BOSTON: :FILE. TXT 



4.5.1 9 /POS - Position to End of Volume 

The /POS switch can be applied to the destination file specification in a 
COPY command when the device is magnetic tape. It positions the file to the 
current end of volume before the transfer. 

Example: 

NFT> COPY MT2:HPFIL.BAC/P0S=B0ST0N: :HPRTN.BAC 
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4.5.20 /RWC - Rewind on Close 

The /RWC switch can be apphed to any file name in a COPY command when 
the device is magnetic tape. It rewinds the tape after the file is closed (after 
the transfer). 

Example: 

NFT> COPY MTl :RMAX.BAS/RWC=BOSTON: zRMAX.BAS 



4.5.21 /RWO - Rewind on Open 

The /RWO switch can be applied to any file name in a COPY command when 
the device is magnetic tape. It rewinds the tape before the file is opened 
(before the transfer). 

Example: 

NFT> COPY MTO:FILEX.R|\IO/RWO = BOSTON: :TEXT,RNO 



4.5.22 /SUPERSEDE - Supersede an Existing File 

This switch can be applied to the destination file specification in a COPY, 
SUBMIT, or PRINT command. If a file already exists at the destination node 
with the same name as that given in the command, the existing file will be 
replaced by the new file. 

Example: 

NFT> COPY FILE, LST/SU = B09T0N: :FILE. TXT 



4.5.23 /TOTAL - Output Directory Size Only 

The /TOTAL switch can be used at the end of the DIRECTORY command to 
output the total size of the directory. Individual directory entries are not 
listed. 

Example: 

NFT> DIR MIAMI: : [1 »2]#.*/T0TAL 



4.5.24 /VARIABLE - Reformat File to Variable Format 

This switch can be applied to the destination file specification in a COPY, 
APPEND, SUBMIT, or PRINT command. It converts a file from stream 
ASCII at the source node to RMS-11 variable-length record format with 
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implied carriage control. This switch is used mainly to transfer stream 
ASCII files from a DECnet/E or DECnet/RT node to an RSX or VAX/VMS 
node because RSX and VAX/VMS do not process stream ASCII files. 

Example: 

NFT:> copy DALLAS: :FIL.MAC/VA = TEST. mac 

This example copies a MACRO file from a DECnet/E node to the RSX node 
in the sample network. 

NOTE 

The /VARIABLE switch is incompatible with and should 
not be used with the /BLOCK switch, described in Section 
4.5.3. 



4.6 NFT Error Messages 



The error messages in this section are printed by NFT when you make some 
mistake in typing an NFT command (syntax errors) or when an error has 
occurred in initializing NFT. These errors are described in this section. 

Other error messages may appear for conditions diagnosed according to the 
Data Access Protocol (DAP) or by RMS (Record Management Services, used 
by NFT and FAL to do local I/O). These error messages are given in 
Appendix D. 

?NFT- Attempted continuation is illegal 

You cannot continue a one-line CCL command with the /MORE or - 
switch. 

?NFT - Break buffer overflow 

There are too many quotes, commas, underscores, and equal signs in the 
command. The current limit on these special characters per command is 
40. 

?NFT - File specification too long 

The file specification you typed is too long to fit in an internal buffer used 
by NFT. 

?NFT - GMCR$ directive failure 

Tell your software specialist that the RSX-llM directive used to read 
the CCL command line has failed. Then retype the command, starting 
NFT with RUN $NFT. 
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?NFT- Invalid command format 

Can be caused by several errors: 

1. Trying to type something other than a node name in a NODESPECI- 
FICATION command. 

2. Typing "::" in a NODESPECIFICATION command without any node 
name. 

3. Using any switch other than /IDENTIFY of /INQUIRY in a DELETE 
or EXECUTE command. 

4. Not typing an equal sign ( = ) in an APPEND command. 

5. Typing an equal sign ( = ) in a DELETE, TYPE, or EXECUTE 
command. 

6. Typing anything but COMMANDS or SWITCHES after a HELP 
command. 

7. Not typing a node name in an EXECUTE command. 

?NFT - Invalid network node name 

Valid node names are 1 to 6 uppercase, alphanumeric characters and 
must contain at least one letter. 

?Ni=T - Invalid node name specification 

Either the node name is not in the right place or it contains non- 
alphanumeric characters. 

?NFT - IMore than one input node specification 

You cannot type more than one node name on the right side of an equal 
sign. 

?NFT- More than one output node specification 

You carmot type more than one node name on the left side of an equal 
sign. 

?NFT- No node name given for /IDENTIFY 

No node name was given for the /IDENTIFY switch to operate on. 

?NFT- RMS initialization failure 

An error occurred in initializing RMS. If the error persists, call a soft- 
ware specialist. 

?NFT- Too many /IDENTIFY switches 

More than one /IDENTIFY switch was given on one side of an equal sign. 
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?NFT - Too many output file specifications 

More than one file name was given on the left side of an equal sign. 

?NFT - Too many = signs 

The command typed contains more than one equal sign. 

?NFT - Unmatched quote characters 

There are an odd number of quote characters in the command line. Quote 
characters must be paired. 

?NFT - Unrecognizable command 

Valid command keywords are described in Section 4.4. 

?NFT - Unrecognizable switch 

Valid switches are described in Section 4.5. 
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Chapter 5 

NETCPY: Network Copy between Devices 



The NETCPY utility allows you to copy all of the information on a DECtape, 
magtape, floppy disk, or disk from one DECnet/E node to a similar device on 
another DECnet/E node. One of the nodes must be the local node and both 
must be DECnet/E nodes. (NETCPY is a DECnet/E utility. There is no gen- 
eral DECnet utility to copy the contents of devices between nodes.) 

To protect devices from unauthorized use, a NETCPY user must supply log- 
in information for the remote node specified in the command. NETCPY will 
prompt for the information and check its validity before allowing the trans- 
fer to proceed. You can use the TLK utility (Chapter 2) to ask the operator at 
the remote DECnet/E system to mount tapes or do other preliminary prepa- 
ration of the physical devices. 



RUN SNETCPY 
>MT3: = BOSTON:: MT2/FC 
REMOTE PPN 7120,153 

REMOTE PASSWORD ? (not echoed) 
100 BLOCKS TRANSFERRED 
200 BLOCKS TRANSFERRED 
TIME TO COPY - 5.321 17 MIN 
COPY COMPLETE 



READY 




BOSTON 



MIAMI 



Figure 5-1 NETCPY Copies an Entire Device from One DECnet/E 
Node to Anotlier DECnet/E Node 
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5.1 Running NETCPY 

You can run NETCPY from any terminal in a DECnet/E system by t5^ing: 

RUN $NETCPY 

NETCPY responds with a message identifying itself and a pound-sign 
prompt (#). It will then accept one command. After you type the command, 
NETCPY will prompt for log-in information for the remote node, process the 
command, and terminate. Only one copy command can be given each time 
NETCPY is run. 

RUN $NETCPY 

NETCPY V2.0 RSTS V7.1 DECNET/E 

^command 

REMOTE PPN ? ppn 

REMOTE PASSWORD ? password 

(NETCPY processes command, lists progress) 

Ready 

The ppn is the project-programmer number used to log in at the remote sys- 
tem - for example, 100,153. Likewise, the password is used to log in at the 
remote system. It is not echoed as you type it. 

The command is described in detail in the next section. 

5.2 General Form of NETCPY Command 

General Form of Command: 

[dstnode::]dstdevice:[dstsw] = [srcnode::]srcdevice: i/FC ) [srcsw] 

(/NCl 

Parameter Descriptions: 

dstnode 

The dstnode is the destination node - the 1- to 6-character, uppercase, 
alphanumeric node name to which the contents of the device are to be cop- 
ied. The name must begin with at least one letter. If this node name is 
omitted, the local node is assumed. Either srcnode or dstnode MUST be the 
local node. Both must be DECnet/E nodes. 

dstdevice 

The dstdevice is the destination device. Allowable devices include the 
following: 

MTre: Magtape unit n 

DXn: Floppy disk unit n 

DK«: Disk unit n 

DTre: DECtape unit n 
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The destination device must be the same type as the device specified by 
srcdevice. NETCPY can be used to copy larger disks as well, but the speed of 
most transmission lines usually makes such operations impractical for 
remote transfers. 

dstsw 

Either or both of the optional switches /PA and /DE can be used, as described 
in Section 5.3. 



The equal sign separates the destination description from the source 
description. 

srcnode 

The srcnode is the source node - the node from which the information is to 
be copied. If this name is omitted, the local node is assumed. Either dstnode 
or srcnode MUST be the local node. Both must be DECnet/E nodes. 

srcdevice 

The srcdevice is the source device. Allowable devices include the following: 

MTn: Magtape unit n 

DXn: Floppy disk unit n 

DKn: Disk unit n 

DTn: DECtape unit n 

The source device must be the same type as the device specified by dstdevice. 

IFC 

The /FC switch indicates that a fast copy is to be done. 

INC 

The /NC switch indicates no copy is to be done. It is used with the /VE switch 
for a verify-only run. 

srcsw 

Any or all of the optional switches /VERIFY, /BLOCK, /PARITY, and 
/DENSITY can be used, as described in Section 5.3. Switches can be abbre- 
viated to the first two characters of the kejrword. 

Example: 

«BOSTON: : MTl : =MT2 : /FC 

This command will cause the magtape device unit 2 at the local node to be 
copied to magtape device 1 at node BOSTON. The fast copy (/FC) switch is 
used to cause the copy. 



NETCPY: Network Copy between Devices 5-3 



5.3 NETCPY Option Switches 



There are seven option switches that can be used with NETCPY. These are 
listed below and described in the following subsections. 

/BLOCK Specify Block size for magtape. 

/DENSITY Set the density for magtape. 

/FC Request a device copy. 

/HELP Obtain instructional information. 

/NC Request no device copy. 

/PARITY Set the parity for magtape. 

/VERIFY Verify that the data is copied correctly. 

5.3.1 /BLOCK:& - Block Size Switch 

The /BLOCK switch, specifying block size, will allocate buffers for magtapes 
written with nonstandard record sizes. The default block size is 2048-byte 
blocks, which will handle most tapes and allows fast disk copies. Block (b) 
sizes must be in multiples of 512 bytes. The srcdevice is buffered at the speci- 
fied block size and the dstdevice is written (and/or verified) at the specified 
block size. 

Example: 

»»MTO : = BOSTON : : HT 1 : /BL : 4096/ FC 

This command will cause magtape unit 1 at node BOSTON to be copied to 
magtape unit at the local node in 4096-byte blocks, rather than the default 
of 2048-byte blocks. 

5.3.2 /DENSITY :d - Set Density Switch 

The /DENSITY switch can be used when copying magtapes to set the den- 
sity for either the source or destination device. The d parameter can be 
either 800 or 1600 bits per inch (BPI). 

Example: 

«»MTO: /DENSITY: 1600/ PAR ITY : EMEN = BOSTOI\l : : MT 1 : /DENS ITY : BOO/FC 

NETCPY reads a 9-track magtape on unit 1 at node BOSTON at 800 BPI 
and writes in 9-track format on magtape unit at the local node at 1600 BPI 
with even parity (see Section 5.3.6). 
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5.3.3 /FC - Fast Copy Switch 

The /FC switch is used to request a device copy. Either /FC or /NC must be 
used after the srcdevice specification. If neither is used, NETCPY takes no 
action and prints an error message. 

NETCPY lists the progress of the copy in 100-block units for disk and in 
100-record units for tape. When the copy is complete, NETCPY lists the 
time it took and the total number of blocks or records transferred. 

Example: 

RUN *NETCPY 

NETCPY y2.0 RSTS M7.1 DECNET/E 

«BOSTON! :DT0:=DT2:/FC 

REMOTE PPN ? 1 .222 

REMOTE PASSWORD ? 

100 BLOCKS TRANSFERRED 

200 BLOCKS TRANSFERRED 

300 BLOCKS TRANSFERRED 

400 BLOCKS TRANSFERRED 

500 BLOCKS TRANSFERRED 
TIME TO COPY = 5.11111 MIN 
COPY COMPLETE 
BLOCKS TRANSFERRED = 578 

Ready 



5.3.4 /HELP -Help Switch 

You can t5q)e /HE in response to the pound-sign prompt and get a help dis- 
play at the terminal. After the help information is displayed, another 
pound-sign prompt is given and you can then type a command. 

Example: 

RUN $NETCPY 

NETCPY V2.0 RSTS VT.l DECNET/E 

#/HE 



(Help Display) 



tt (command) 



5.3.5 /NC- No Copy Switch 

The /NC switch is used to request no copy. This switch is always used with 
the /VE (verify) switch for a verify-only run. Either /NC or /FC must be used 
after the srcdevice specification. The /NC switch has no effect by itself. 
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5.3.6 /PARITY:p- Set Parity Switch 

The /PARITY switch can be used when copying magtapes to set the parity 
for either the source or destination device. The p parameter can be either 
"ODD" or "EVEN". The default is whatever was set by the system manager 
for that device at the node referenced. 

An example of the use of the /PARITY switch is given in Section 5.3.2. 



5.3.7 /VERIFY - Verify Switch 

This switch can be used with either the /FC or /NC switch to verify that the 
information on a device unit has been copied exactly. Verification is per- 
formed block by block and takes as much time as the copy operation. When 
used with /FC, the information is first copied from the source device to the 
destination device, and then sent back to be verified. When used with /NC, 
the information is simply verified. As the verification is performed, NET- 
CPY lists the progress. 

Example: 

RUN $NETCPY 

NETCPY U2,0 RSTS ^7.1 DECNET/E 

•BOSTON: 5 DTO : =DT2 : /NC/ME 

REMOTE PPN ? 1 '222 

REMOTE PASSWORD ? 

BEGINNING VERIFICATION PASS 

100 BLOCKS UERIFIED 

200 BLOCKS VERIFIED 

300 BLOCKS VERIFIED 

400 BLOCKS VERIFIED 
VERIFICATION COMPLETE BAD BLOCKS 
OUT OF 492 BLOCKS VERIFIED 

Ready 

If the information has not been copied correctly, NETCPY prints the deci- 
mal number of blocks or records in which inconsistencies appear. The num- 
bers printed correspond to magtape record numbers and to disk and 
DECtape blocks of 512 bytes. 

Example: 



#DX1:=B0ST0N: :DX2/FC/ME 


REtlOTE 


PPN ? 102 »50 


REMOTE 


PASSWORD ? 


100 


BLOCKS TRANSFERRED 


200 


BLOCKS TRANSFERRED 


300 


BLOCKS TRANSFERRED 


400 


BLOCKS TRANSFERRED 


TIME TO COPY = 7.5GBB7 MIN 


COPY COMPLETE 


BLOCKS 


TRANSFERRED »492 
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BEGINNING yERIFICATION PASS 

THE FOLLOWING BLOCKS ARE BAD 

17 

31 

89 

100 BLOCKS VERIFIED 

200 BLOCKS VERIFIED 

300 BLOCKS VERIFIED 

iSOO BLOCKS VERIFIED 

VERIFICATION COMPLETE 3 BAD BLOCKS 
OUT OF aSZ BLOCKS VERIFIED 



Ready 



5.4 NETCPY Error Messages 

Cannot specify both /FC and /NC 

Either fast copy (/FC) or no copy (/NC) option must be specified, but not 
both. 

Error in specifying density 

The density selected is not one of the valid values 200, 556, 800, DUMP, 
or 1600. 

Error in specifying parity 

The parity selected must be either ODD or EVEN. 

/FC or /NC must be specified 

Either fast copy (/FC) or no copy (/NC) must be specified. 

Illegal block size 

The block size selected with the /BL option must be a multiple of 512. 

Invalid node specification 

Either the nodes specified did not include the local node, or NETCPY did 
not recognize the node name typed. 

Must have same type device 

Both the source device and the destination device must be magtape 
(MTn:), DECtape (DT/i:), floppy disk (DXn:), or disk (DKre:). 
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(NSP command) - ABORT 

NETCPY sets up a logical link to the remote node to effect the transfer 
requested. If any network error occurs during execution of NETCPY, the 
program is aborted and this message is printed. The NSP command 
printed is the one NETCPY was trying to execute when the error 
occurred. For example, if NETCPY was trying to receive a message from 
the remote node, the message RECEIVE NETWORK ERROR - PRO- 
GRAM ABORT is printed. 

Type /HE for help 

NETCPY does not recognize the command typed. Use the /HE switch for 
help. 
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Chapter 6 

NETOFF: Network Shutdown 



The NETOFF utility lets you shut down your network in an orderly fashion 
without shutting down the entire RSTS/E operating system. It causes a 
gradual shutdown rather than an immediate disconnect. 

NETOFF performs a similar operation to the NCP SET EXECUTOR 
STATE SHUT command (see DECnetlE System Manager's Guide). Both per- 
mit existing logical links to complete before ending network operations, but 
only NETOFF warns users that the network will close down in some deter- 
mined period of time. This gives network users an opportunity to respond to 
the warning message by finishing up network processing or by requesting 
that network operations be extended. 

To invoke NETOFF, you type: 

RUN $NETOFF 

NETOFF responds by asking how many minutes it should wait before new 
network links are prohibited (that is, until it effects a SET EXECUTOR 
STATE SHUT command) and how many minutes it should wait until actual 
network shutdown. 

After this, the following sequence of operations occurs: 

1. NETOFF broadcasts a message to all system terminal users: 
THE NETWORK IS SHUTTING DOWN IN [variable] minutes 

2. NETOFF then suspends execution for the appropriate number of min- 
utes, as determined in the dialog. When it resumes execution, it 
sends the SET EXECUTOR STATE SHUT message to NSP. If no log- 
ical links are open, NSP terminates network operations and the 
NETOFF program completes. Otherwise, NSP prohibits the forming 
of any new logical links, but allows normal operations to continue on 
existing links. 

3. NETOFF again suspends execution, this time for the remainder of 
the period before final network shutdown. When it resumes execu- 
tion, it sends the SET EXECUTOR STATE OFF message to NSP. 

4. At this point, NSP aborts any existing logical links and sends a Net- 
work Abort message to any local programs with links open. NSP then 
shuts down Transport, thus ending network operations. 

5. Finally, NETOFF sends a STOP command to the Event Logger pro- 
gram and displays the following message on the terminal: 

SHUTDOWN COMPLETE 
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You can interrupt this sequence at any point by tjrping CTRL/C. NETOFF 
resumes execution and sends the SET EXECUTOR STATE ON command to 
NSP, aborting the shutdown procedure and resuming normal network 
operations. 
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Appendix A 
Object Type Codes 



Code Type of Process 

000 General Task, User Process 

001 File Access (FAL/DAP Version 1) 

002 Unit Record Services (URD) 

003 Application Terminal Services (ATS) 

004 Command Terminal Services (GTS) 

005 RSX-1 IM Task Gontrol, Version 1 

006 Operator Services Interface 

007 Node Resource Manager 

008 IBM 3270-BSC Gateway 

009 IBM 2780-BSC Gateway 

010 IBM 3790-SDLC Gateway 
Oil TPS Application 

012 RT-1 1 DIBOL Application 

013 TOPS-20 Terminal Handler 

014 TOPS-20 Remote Spooler 

015 RSX-llM Task Control, Version 2 

016 TLK Utility 

017 File Access (FAL/DAP Version 4 and later) 

018 RSX-llS Remote Task Loader 

019 Network Management Listener (NICE Process) 

020 RSTS/E Media Transfer Program (NETCPY) 

021 Reserved for DECnet use 

022 Mail Listener 

023 Host Terminal Handler (NPKDVR) 

024 Concentrator Terminal Handler 

025 Loopback Mirror 

026 Event Receiver 

027 V AXA^MS Personal Message Utility 

028 File Transfer Spooler (FTS) 
029-062 Reserved for DECnet use 
063 DECnet test tool (DTR) 
064-127 Reserved for DECnet use 
128-255 Reserved for customer extensions 
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Appendix B 

NSP Reason Codes for Connect Reject and Link Abort 



Code Reason 

000 No error - user-initiated reject or abort 

001 Resource allocation failure 

002 Destination node does not exist 

003 Node shutting down 

004 Destination program does not exist 

005 Invalid destination name or source field 

006 Destination program's queue full 

007 Unspecified error condition 

008 Third party aborted logical link 

009 User-initiated link abort 
010-020 Reserved 

02 1 Invalid destination address in Connect Initiate Message 

022 Invalid desination address in Connect Confirm Message 

023 Source address zero in Connect Initiate or Connect Confirm Message 

024 Flow control violation - invalid request count in Link Service Message 
025-031 Reserved 

032 Too many connects to node 

033 Too many connects to destination program 

034 Access not permitted 

035 Logical link services mismatch 

036 Invalid accounting information 

037 Segment size too small 

038 User aborted, timed out, or canceled link 

039 No path to node 

040 Flow control failure - data received when request count zero 

041 No current link (cannot recognize destination address) 

042 Confirmation from remote system of Disconnect Message 

043 Image data field too long 
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Appendix C 

NETACT: Automatic Log-in Utility for NFT 



The NETACT utility lets you define log-in entries for remote nodes so that 
you do not have to define them each time you run NFT. NETACT creates a 
file in your account (NETACT.DAT) that NFT uses to provide access control 
information whenever you reference a new remote node name in an NFT 
command. If the access control information specified in the file is sub- 
sequently rejected by the remote node, NFT will delete the entry from its 
internal data structures. It does not, however, delete the entry from 
NETACT.DAT. 

The NFT command NODESPECIFICATION and the /IDENTIFY switch 
takes precedence over the NETACT.DAT file in an NFT run. 

C.1 How to Run NETACT 

You can run NETACT from any terminal in a DECnet/E system by typing: 
RUN $NETACT 

NETACT displays a message identifying itself and a prompt: NETACT>. It 
will then accept commands until you use the EXIT command to terminate 
NETACT. You can also type a CTRL/Z at any point during execution of 
NETACT. 

RUN INETACT 

NETACT V2.0 RSTS V7.1 The ARK 

NETACT>commared 



NETACT>^Z 
Ready 

C.2 NETACT Commands 

Six commands providing five functions are available with NETACT. These 
commands are listed below and described in the following subsections. Each 
command can be abbreviated to the first letter of the keyword. 

DEFINE Lets you define a log-in sequence for a remote node. 

EXIT Terminates NETACT. 

HELP or ? Displays a line of helpful information at your terminal. 

LIST Displays the current definitions. 

PURGE Eliminates a log-in sequence for a remote node. 
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C.2.1 DEFINE Command 

The DEFINE command displays a series of questions. You respond to these 
questions to define a log-in sequence for a node. 

Example: 



NETACT>DEFINE 








Node name 




? 


DENVER 


User: 


<> 


? 


2.155 


Passwo rd : 


<> 


7 


MELBA 


Account: 


<> 


? 


3N4 



NETACT stores the entries in the file accessed by NFT. Thereafter, when 
the user types an NFT command referring to node DENVER, the project- 
programmer number (2,155), the password (MELBA), and account (3N4) 
will be used to gain access to node DENVER. 

Note that although the password is displayed as you type it, NETACT uses a 
simple two-way encryption to write it to the file NETACT.DAT. A malicious 
user cannot determine your passwords by displaying the file NETACT.DAT 
from your account. 

To redefine entries for a node, use the DEFINE command again. 
Example: 

NETACT>DEFINE 

Node nawe ? DENMER 

User: <2 ,155> ? 2 .154 

Password: <MELBA> ? 

Account: <3N4> ? 

When you type a node name for which NETACT already has a definition, 
the current entries are displayed in angle brackets. You can change an 
entry by typing new values, as in the previous example. Depress the 
RETURN key to leave the entry unchanged. (Thus, the password MELBA is 
retained in the new entry created by the preceding example.) Depress the 
ESCAPE key to delete the entry entirely. (The account 3N4 is simply 
deleted in the preceding example; no new account is entered.) 



C.2.2 EXIT Command 

You can terminate NETACT by typing EXIT in response to the prompt. You 
can also terminate NETACT at any point by typing a CTRL/Z. If this is done 
while NETACT is waiting for response to a node name, user, password, or 
account prompt, the last command typed is not processed. 

Example: 

NETACT>EKIT 



Ready 
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or 



NETACT>DEFINE 

Node name ? DALLAS 

Users <2.154> ? 2,117 

Password: <MELBA> ? "Z 



Ready 



In the last example, the entire DEFINE command for node DALLAS is 
ignored; the original entries are retained. 



C.2.3 HELP Command 

The HELP command displays information. It has two forms. 

NETACT>HELP 

or 

NETACT>? 

C.2.4 LIST Command 

The LIST command displays current definitions. 
Example: 

NETACT>LIST 



Node BOSTON 

User 1.117 

Password AGHAST 
Account 



Node DENVER 

User 2(154 

Password MELBA 
AcGount 



C.2.5 PURGE Command 

The PURGE command eliminates a current entry. 
Example: 

NETACT>PURGE 

Node name ? DALLAS 

Node DALLAS pursfed from file. 
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C.3 NETACT Error Messages 

Field too long 

You have entered too many characters. The following limits apply: 

Node name is limited to 6 characters. 
User is limited to 16 characters. 
Password is limited to 8 characters. 
Account is limited to 16 characters. 

Illegal command - command Type "Help" for help 

The command you just typed is not a valid NETACT command. Typing 
"HELP" will display the commands acceptable to NETACT. 

Invalid node name 

The nodename field cannot be null. 

Node nodename not defined. 

You are trying to purge a node definition that does not exist. Check the 
node name you typed for misspelling. Issue a LIST command to see cur- 
rent definitions. 
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Appendix D 

Error Messages Generated by RMS and DAP 



This appendix contains non-NFT error messages that can appear while 
using the Network File Transfer (NET) program. These messages can 
appear for conditions diagnosed by the Record Management Services (RMS), 
used by NFT and FAL to do local input and output, or for violations of the 
Data Access Protocol (DAP), used to do remote file transfers across the 
network. 



D.I NFT Error Messages from RMS-1 1 

NFT prints the following error message in response to detected RMS-1 1 
errors: 

?NFT- RMS ERROR = nnnnnn 

The errors that can occur when you use NFT should be fairly under- 
standable, such as error 176440, "File not found." However, all possible 
RMS errors are listed here, and some descriptions will be obscure to all but 
those familiar with RMS. If you get one of these errors repeatedly, call a 
software specialist and report the error. 

NOTE 

The following list reflects errors generated by RMS Version 
1.8 as described in the RMS-11 MACRO-11 Reference 
Manual. 



Octal 
Value 
(nnnnnn) 

177760 



177720 
177700 
177660 



Description 

Operation aborted: Stack save area exhausted or in-core data 
structures corrupted. 

Files-11 ACP could not access the file. 

File activity precludes action (e.g., attempting to close a file 
with outstanding asynchronous record operation). 

Bad area identification number (AID) field in allocation XAB 
(i.e., out of sequence). 

Invalid value in alignment boundary tj^e (ALN) field of allo- 
cation XAB. 



(continued on next page) 
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Octal 
Value 
{nnnnnn) Description 

177640 Value in allocation quantity (ALQ) field in FAB (or allocation 

XAB) exceeds maximum or, during an explicit $EXTEND 
operation, equals zero. 

177620 Records in a field on ANSI-labeled magnetic tape are variable 

length but not in ANSI-D format. 

177600 Invalid value in allocation options (AOP) field in allocation 

XAB. 

177560 Invalid operation at AST level: Attempting to issue a syn- 

chronous operation from an asynchronous record operation 
completion routine. 

177540 Read error on file header attributes. 

177530 Invalid file ID. 

177520 Write error on file header attributes. 

177500 Bucket size (BKS) field in FAB contains value exceeding 

maximum. 

177460 Bucket size (BKZ) field in allocation XAB contains value 

exceeding maximum. 

177440 Block length (BLN) field in a FAB, RAB, or XAB is incorrect. 

177430 Beginning of file detected on $SPACE operation to magnetic 

tape file. 

177420 Private buffer pool address not a double word boundary. 

177400 Private buffer pool size not a multiple of 4. 

177360 Internal error detected in RMS-11. No recovery possible; con- 

tact a software specialist. 

177340 Cannot connect RAB (i.e., only one record access stream per- 

mitted for sequential files). 

177320 $UPDATE attempting to change a key field that does not 

have the change attribute. 

177300 Index file bucket check-byte mismatch. The bucket has been 

corrupted. Recovery can be attempted by: 

1. Moving disk pack to another device and trying the process 
again. 

2. Recreating file using either RMSIFL or RMSONV utility. 

3. Restoring file from last backup. 

(continued on next page) 
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Octal 
Value 
(nnnnnn) 

177260 
177240 

177220 
177200 

177160 
177140 
177120 
177100 



177070 

177060 
177040 

177020 
177000 
176770 
176760 
176740 

176720 
176700 

176640 
176630 
177620 
176600 



Description 

$CLOSE function failed. 

Invalid OOD field in XAB or XAB type is invalid for the 
organization or operation. 

Files-11 ACP could not create file. 

No current record: Operation not immediately preceded by a 
successful $GET or $FIND. 

Files-11 ACP deaccess error during $CLOSE. 

Invalid area number in DAN field of key definition XAB. 

Record accessed by RFA access mode has been deleted. 

1. Syntax error in device name. 

2. No such device. 

3. Inappropriate device for operation (e.g., attempting to cre- 
ate an indexed file on magnetic tape). 

Files-11 ACP could not write bucket. RMS-11 deferred the 
I/O operation until it needed the I/O buffer for another bucket 
because the user program speciiied deferred writes. 

Syntax error in directory name. 

Dynamic memory exhausted: Insufficient space in central 
space pool or private buffer pool. 

Directory not found. 

Device not ready. 

Device positioning error. 

DTP field invalid (STV = @XAB). 

Duplicate key detected, "duplicates allowed" attribute not set 
for one or more key fields. 

Fiels-11 ACP enter function failed. 

Environment error: Operation or file organization not speci- 
fied in ORG$ macro. 

Expanded string area in NAM block too short. 

File expiration date not reached. 

File extend failure. 

Not a valid FAB: BID field does not contain FB$BID. 

(continued on next page) 
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Octal 
Value 
(nnnnnn) 

176560 



176530 
176520 

176500 

176460 
176440 
176420 
176400 
176370 

176360 
176340 
176320 

176300 
176260 

176240 
176220 



Description 

1. Record operation attempted was not declared in FAC field 
of FAB at open time. 

2. Invalid contents in FAC field. 

3. FB$PUT not present in FAC for $CREATE operation. 

Invalid file ID. 

Invalid combination of values in FLG field of key definition 
XAB (e.g., "no duplicates" and "changeable keys"). 

File locked by another user: Cannot access the file because 
sharing specification cannot be met. 

Files-11 ACP $FIND function failed. 

File not found during $OPEN. 

Syntax error in file name. 

Invalid file options. 

System error during FNA/DNA string parse (STV = system 
error code). 

Device full: Cannot create or extend file. 

Invalid area number in IAN field of key definition XAB. 

Index not initialized. This code can only occur in the STV field 
when STS contains ER$RNF. 

Invalid IFI field in FAB. 

Maximum number (254) of key definition or allocation XABs 
exceeded or multiple summary, protection, or date XABs pre- 
sent during operation. 

$INIT or $INITIF macro call never issued. 

Invalid operation. Examples include: 

1. Attempting a $TRUNCATE operation to a nonsequential 
file. 

2. Attempting an $ERASE or $EXTEND operation to a mag- 
netic tape file. 

3. Issuing a block mode operation (e.g., $READ or $WRITE) 
to a stream not connected for block operations. 

4. Issuing a record operation (e.g., $GET, $PUT) to a stream 
connected for block mode operations. 



(continued on next page) 
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Octal 
Value 
{nnnnnn) 

176200 
176160 



176140 
176120 

176100 



176060 

176040 
176020 

176000 
175760 
175750 
175740 
175720 

175700 
175660 



175640 



Description 

Invalid record encountered in sequential file: Invalid count 
field. 

Invalid internal stream identifier (ISI) field in RAB (field may 
have been altered by user) or $CONNECT never issued for 
stream. 

Key buffer address (KBF) field equals 0. 

Record identifier (i.e., the 4-byte location addressed by KBF) 
for random operation to relative file is or negative. 

Invalid key of reference (KRF) in RAB: 

1. During random $GET or $FIND operation, or 

2. During $CONNECT or $REWIND. In this case, ER$KRF 
is returned for the first record operation following the 
$CONNECT or $REWIND. 

Key size equals zero or too large (indexed file) or not equal to 4 
(relative file). 

Invalid area number in LAN field of key definition XAB. 

Magnetic tape is not labeled in accordance with ANSI 
standards. 

Logical channel busy. 

Invalid value in logical channel number (LCH) field of FAB. 

Attempt to extend an area containing an unused extent. 

Invalid value in LOC field of allocation XAB. 

In-core data structures (e.g., I/O buffers) corrupted. This code 
can only occur in the STV field when STS contains ER$ABO. 

Files-11 ACP could not mark file for deletion. 

1. Maximum record number field contains a negative value 
during $CREATE of relative file. 

2. Record identifier (pointed to by KBF) for random operation 
to relative file exceeds maximum record number specified 
when file created. 

Maximum record size (MRS) field contains during $CRE- 
ATE operation and: 

1. Record format is fixed, or 

2. File organization is relative. 

(continued on next page) 
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Octal 
Value 
(nnnnnn) Description 

175620 Odd address in Name Block address (NAM) field in FAB on 

$OPEN, ICREATE, or $ERASE. 

175600 Not at end-of-file: Attempting a $PUT operation to a sequen- 

tial file when stream is not positioned to EOF. 

175560 Cannot allocate internal index descriptor: Insufficient room 

in space pool while attempting to open an indexed file. 

175540 No primary key definition XAB present during $CREATE of 

indexed file. 

175520 $OPEN function failed. 

175500 XABs in chain not incorrect order. 

1. Allocation or key definition XABs not in ascending (or den- 
sely ascending) order. 

2. XAB of another tjrpe intervenes in key definition or alloca- 
tion XAB sub-chain. 

175460 Invalid value in file organization (ORG) field of FAB. 

175440 Error in file's prologue: File is corrupted; recovery can be 

attempted by: 

1. Moving disk pack to another device. 

2. Recreating file using either the RMSIFL or RMSONV 
utility. 

3. Restoring file from latest backup. 

175420 Key position (POS) field in key definition XAB contains a 

value exceeding maximum record size. 

175400 File header contains bad date and time information (retrieved 

by RMS-11 because a date and time XAB is present during an 
$OPEN or $DISPLAY operation). File may be corrupted. 

175360 Privilege violation: Access to the file denied by the operating 

system. 

175340 Not a valid RAB: BID field does not contain RB$BID. 

175320 1. Invalid values in record access mode (RAG) field of RAB. 

2. Illogical value in RAG field (e.g., RB$KEY with a sequen- 
tial file). 

175300 1. Invalid values in record attributes (RAT) field of FAB dur- 

ing $CREATE. 
2. Illogical combination of attributes (e.g., FB$CR and 
FB$FTN) in RAG field during $CREATE. 
(continued on next page) 
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Octal 
Value 
{nnnnnn) 

175260 
175240 

175220 

175200 
175160 

175140 

175120 
175100 



175060 
175040 

175020 
175000 

174760 
174740 



Description 

Record address (RBF) field in RAB contains an odd address 
(block mode access only). 

Files-llACP error: 

1. In record processing - read failure on file block. 

2. In block I/O -VBN = 0. 

Record already exists: During a $PUT operation in random 
mode to a relative file, an existing record found in the target 
record position. 

Invalid RFA in RFA field of RAB during RFA access. 

1. Invalid record format in RFM field of FAB during 
$CREATE. 

2. Specified record format is invalid for file organization. 

Target bucket locked by another task or another stream in 
the same program. 

Files-11 ACP $REMOVE function failed. 

Record identified by KBF/KSZ fields of RAB for random $GET 
or $FIND operation does not exist in relative or indexed file 
(for indexed files only, STV may contain ER$IDX). Record 
may never have been written or may have been deleted. 

$FREE operation issued but no bucket was locked by stream. 

Record options (ROP) field contains invalid values or illogical 
combination of values. 

Error while reading prologue. 

Invalid RRV record encountered in indexed file. File may be 
corrupted. 

Record stream active: In asynchronous environment, 
attempting to issue a record operation to a stream that has a 
request outstanding. 

Record size specified in RSZ of RAB during $PUT or 
$UPDATE is invalid: 

1. RSZ equals zero. 

2. RSZ exceeds maximum record size (MRS) specified when 
file created. 

3. RSZ not equal to size of Current Record for $UPDATE 
operation to a sequential file on disk. 

(continued on next page) 
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Octal 
Value 
[nnnnnn) Description 

4. RSZ does not equal MRS (for fixed format records). 

5. RSZ not large enough to contain Primary Key of indexed 
file. 

174720 Record too big for user's buffer: RMS-11 could not move 

entire record retrieved by $GET operation to user work area 
(UBF/USZ). Note that this error does not destroy the current 
context of the stream. Rather, the stream's context is updated 
as if the operation had been completely successful and as 
much of the record as possible is moved to user buffer. 

174710 RRV update error on insert. 

174700 During $PUT operation, key of record to be written is not 

equal to or greater than key of previous record (and RAC field 
contains RB$SEQ). 

174660 Illogical value in SHR field of FAB (e.g., FB$WRI specified for 

sequential file). 

174640 Invalid SIZ field in key definition XAB during $CREATE 

(e.g., specified size exceeds maximum record size). 

174620 During asynchronous record operation, RMS-11 has found 

that the stack is too big to be saved. This code can only occur 
in the STV field when STS contains ER$ABO. 

174600 System directive error. 

174560 Index tree error: Indexed file is corrupted. 

174540 Syntax error in file type (e.g., more than 3 characters 

specified. 

174520 Invalid address in user buffer (UBF) field of RAB: 

1. UBF contains 0, or 

2. UBF not word aligned (for block mode access only). 

174500 Invalid user buffer size (USZ) field in RAB (i.e., USZ contains 

0). 

174440 Invalid VOL field in allocation XAB (i.e., VOL does not con- 

tain 0). 

174430 Wildcard encountered during FNA/DNA string parse. 

174420 File write error. 

174410 Device is write locked. 

(continued on next page) 
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Octal 
Value 
(nnnnnn) 

174400 
174360 

174340 



Description 

Error while writing prologue. 

XAB field in FAB (or NXT field in XAB) contains an odd 
address. 

Extraneous field detected during FNA/DNA string parse. 



D.2 NFT Error Messages from DAP 

NFT prints the following error message in response to an error in NFT/FAL 
communication, violating the Data Access Protocol: 

?NFT - DAP ERROR = aannnn 

The aa value gives the macro or functional group reason for the error. The 
nnnn value gives the micro, or specific, reason for the error. 

Possible values for the macro {ad) field are listed below. 

NOTE 

This list reflects the errors generated as the result of a vio- 
lation of DAP Version 5.6, as described in the DECnet 
DIGITAL Network Architecture, "Data Access Protocol 
Functional Specification," released in October, 1980. 



D.2.1 Macro {aa) Field Values 





1 

2 

3 

4 

5 
6 



Pending 

Successful 

Unsupported 

File Open 
Transfer Error 
Transfer Warning 



Operation in progress 

Returns information that indicates success. 

This implemation of DAP does not support the 
specified request. 

Reserved 

Errors that occur before a file is successfully 
opened. 

Errors that occur after opening a file and 
before closing that file. 

For operations on open files, indicates the 
operation completed, but not with complete 
success. 



Access Termination Errors associated with terminating access to a 

file. 

(continued on next page) 



Error Messages Generated by RMS and DAP D-9 



10 Format Error in parsing a message. Format is not 

correct. 

11 Invalid Field of message is invalid. For example, bits 

that are meant to be mutually exclusive are 
set, an undefined bit is set, a field value is out 
of range, or an invalid string is in a field. 

12 Sync DAP message received out of S3nichronization. 
13-15 Reserved. 

16- 1 7 User-defined STATUS message MACCODE 

field. 



D.2.2 Micro {nnnn) Field Values 

Micro (nnnn) values for use with macro (aa) values of 2, 10, and 11 octal are 
listed below. These refer to the macro Unsupported, Format, and Invalid 
categories. 

NOTE 

Micro (nnnn) Format: Bits 6-11 specify the DAP message 
type number. Bits 0-5 specify the DAP message field 
number. 

Miscellaneous errors: 

00 00 Unspecified DAP message error (catch all) 

00 10 DAP message type field (TYPE) error 

CONFIGURATION message errors by field: 

01 00 Unknown field 

01 10 DAP message flags field (FLAGS) 

01 11 Data stream identification field (STREAMID) 

01 12 Length field (LENGTH) 

01 13 Length extension field (LEN256) 

01 14 Bit count field (BITCNT) 

01 20 Buffer size field (BUFSIZ) 

01 21 Operating system type field (OSTYPE) 

01 22 File system type field (FILESYS) 

01 23 DAP version number field (VERNUM) 

01 24 ECO version number field (ECONUM) 

01 25 USER protocol version number field (USRNUM) 

01 26 DEC software release number field (SOFTVER) 

01 27 User software release number field (USRSOFT) 

01 30 System capabilities field (SYSCAP) 
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ATTRIBUTES message errors by field: 

02 00 Unknown field 

02 10 DAP message flags field (FLAGS) 

02 11 Data stream identification field (STRE AMID) 

02 12 Length field (LENGTH) 

02 13 Length extension field (LEN256) 

02 14 Bit count field (BITCNT) 

02 15 System specific field (SYSPEC) 

02 20 Attributes menu field (ATTMENU) 

02 21 Data type field (DATATYPE) 

02 22 File organization field (ORG) 

02 23 Record format field (REM) 

02 24 Record attributes field (RAT) 

02 25 Block size field (BLS) 

02 26 Maximum record size field (MRS) 

02 27 Allocation quantity field (ALQ) 

02 30 Bucket size field (BKS) 

02 31 Fixed control area size field (FSZ) 

02 32 Maximum record number field (MRN) 

02 33 Run-time system field (RUNSYS) 

02 34 Default extension quantity field (DEQ) 

02 35 File options field (FOP) 

02 36 Byte size field (BSZ) 

02 37 Device characteristics field (DEV) 

02 40 Spooling device characteristics field (SDC) 

02 41 Longest record length field (LRL) 

02 42 Highest virtual block allocated field (HBK) 

02 43 End offile block field (EBK) 

02 44 First free byte field (FFB) 

02 45 Starting LBN for contiguous file (SBN) 

ACCESS message errors by field: 

03 00 Unknown field 

03 10 DAP message flags field (FLAGS) 

03 11 Data stream identification field (STRE AMID) 

03 12 Length field (LENGTH) 

03 13 Length extension field (LEN256) 

03 14 Bit count field (BITCNT) 

03 15 System specific field (SYSPEC) 

03 20 Access function field (ACCFUNC) 

03 21 Access options field (ACCOPT) 

03 22 File specification field (FILESPEC) 

03 23 File access field (FAC) 

03 24 File sharing field (SHR) 
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03 25 Display attributes request field (DISPLAY) 

03 26 File password field (PASSWORD) 

CONTROL message errors by field: 

04 00 Unknown field 

04 10 DAP message flags field (FLAGS) 

04 11 Data stream identification field (STREAMID) 

04 12 Length field (LENGTH) 

04 13 Length extension field (LEN256) 

04 14 Bit count field (BITCNT) 

04 15 System specific field (SYSPEC) 

04 20 Control function field (CTLFUNC) 

04 21 Control menu field (CTLMENU) 

04 22 Record access field (RAG) 

04 23 Key field (KEY) 

04 24 Key of reference field (KRF) 

04 25 Record options field (ROP) 

04 26 Hash code field (HSH) 

04 27 Display attributes request field (DISPLAY) 

CONTINUE TRANSFER message errors by field: 

05 00 Unknown field 

05 10 DAP message flags field (FLAGS) 

05 11 Data stream identification field (STREAMID) 

05 12 Length field (LENGTH) 

05 13 Length extension field (LEN256) 

05 14 Bit count field (BITCNT) 

05 15 System specific field (SYSPEC) 

05 20 Continue transfer function (CONFUNC) 
ACKNOWLEDGE message errors by field: 

06 00 Unknown field 

06 10 DAP message flags field (FLAGS) 

06 11 Data stream identification field (STREAMID) 

06 12 Length field (LENGTH) 

06 13 Length extension field (LEN256) 

06 14 Bit count field (BITCNT) 

06 15 System specific field (SYSPEC) 

ACCESS COMPLETE message errors by field: 

07 00 Unknown field 

07 10 DAP message flags field (FLAGS) 

07 11 Data stream identification field (STREAMID) 

07 12 Length field (LENGTH) 

07 13 Length extension field (LEN256) 
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07 


14 


07 


15 


07 


20 


07 


21 


07 


22 



Bit count field (BITCNT) 
System specific field (SYSPEC) 

Access complete function field (CMPFUNC) 
File options field (FOP) 
Checksum field (CHECK) 



DATA message errors by field: 

10 00 Unknown field 



10 


10 


10 


11 


10 


12 


10 


13 


10 


14 


10 


15 


10 


20 


10 


21 



DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Record number field (RECNUM) 
File data field (FILEDATA) 





10 




11 




12 




13 




14 




15 




20 




21 




22 




23 




24 



STATUS message errors by field: 

11 00 Unknown field 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Macro status code field (MACCODE) 
Micro status code field (MICCODE) 
Record file address field (RFA) 
Record number field (RECNUM) 
Secondary status field (STV) 

KEY DEFINITION message errors by field: 

12 00 Unknown field 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Key definition menu field (KEYMENU) 
Key option flags field (FLG) 
Data bucket fill quantity field (DEL) 
Index bucket fill quantity field (IFL) 
Key segment repeat count field (SEG€NT) 



12 


10 


12 


11 


12 


12 


12 


13 


12 


14 


12 


15 


12 


20 


12 


21 


12 


22 


12 


23 


12 


24 
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12 25 Key segment position field (POS) 

12 26 Key segment size field (SIZ) 

12 27 Key of reference field (REF) 

12 30 Key name field (KNM) 

12 31 Null key character field (NUL) 

12 32 Index area number field (IAN) 

12 33 Lowest level area number field (LAN) 

12 34 Data level area number field (DAN) 

12 35 Key data type field (DTP) 

12 36 Root VBN for this key field (RVB) 

12 37 Hash algorithm value field (HAL) 

12 40 First data bucket VBN field (DVB) 

12 41 Data bucket size field (DBS) 

12 42 Index bucket size field (IBS) 

12 43 Level ofroot bucket field (LVD 

12 44 Total key size field (TKS) 

12 45 Minimum record size field (MRL) 

ALLOCATION message errors by field: 

13 00 Unknown field 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Allocation menu field (ALLMENU) 
Relative volume number field (VOL) 
Alignment options field (ALN) 
Allocation options field (AOP) 
Starting location field (LOG) 
Related file identification field (RFI) 
Allocation quantity field (ALQ) 
Area identification field (AID) 
Bucket size field (BKZ) 
Default extension quantity field (DEQ) 

SUMMARY message errors by field: 

14 00 Unknown field. 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Summary menu field (SUMENU) 
Number of keys field (NOK) 
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13 


10 


13 


11 


13 


12 


13 


13 


13 


14 


13 


15 


13 


20 


13 


21 


13 


22 


13 


23 


13 


24 


13 


25 


13 


26 


13 


27 


13 


30 


13 


31 



14 


la 


14 


11 


14 


12 


14 


13 


14 


14 


14 


15 


14 


20 


14 


21 



22 


23 


24 



15 


10 


15 


11 


15 


12 


15 


13 


15 


14 


15 


15 


15 


20 


15 


21 


15 


22 


15 


23 


15 


24 



Number of areas field (NO A) 

Number of record descriptors field (NOR) 

Prologue version number (PVN) 

DATE AND TIME message errors by field: 

15 GO Unknown field 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Date and time menu field (DATMENU) 
Creation date and time field (CDT) 
Last update date and time field (RDT) 
Deletion date and time field (EDT) 
Revision number field (RVN) 

PROTECTION message errors by field: 

16 00 Unknown field 

DAP message flags field (FLAGS) 

Data stream identification field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Protection menu field (PROTMENU) 
File owner field (OWNER) 
System protection field (PROTSYS) 
Owner protection field (PROTOWN) 
Group protection field (PROTGRP) 
World protection field (PROTWLD) 

NAME message errors by field: 

17 00 Unknown field 

DAP message flages fleld (FLAGS) 

Data stream identiflcation field (STREAMID) 

Length field (LENGTH) 

Length extension field (LEN256) 

Bit count field (BITCNT) 

System specific field (SYSPEC) 

Name type field (NAMETYPE) 
Name field (NAMESPEC) 



16 


10 


16 


11 


16 


12 


16 


13 


16 


14 


16 


15 


16 


20 


16 


21 


16 


22 


16 


23 


16 


24 


16 


25 



17 


10 


17 


11 


17 


12 


17 


13 


17 


14 


17 


15 


17 


20 


17 


21 
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ACCESS CONTROL LIST message errors by field: (Reserved for future 
use) 

20 00 Unknown field 

20 10 DAP message flags field (FLAGS) 

20 11 Data stream indentification field (STRE AMID) 

20 12 Length field (LENGTH) 

20 13 Length extension field (LEN256) 

20 14 Bit count field (BITCNT) 

20 15 System specific field (SYSPEC) 

20 20 Access control list repeat count field (ACLCNT) 

20 21 Access control list entry field (ACL) 

Micro (nnnn) values for use with macro iaxx) values of 0, 1, 4, 5, 6, and 7 
octal, are listed below. 

NOTE 

Micro (nnnn) Format: Bits 0-11 contains error code num- 
ber. Symbolic status codes, where supplied, refer to the cor- 
responding RMS status codes. They are included here for 
ease of reference only - they have no meaning for DAP. 



0000 




0001 


ER$ABC 


0002 


ER$ACC 


0003 


ER$ACT 


0004 


ER$AID 


0005 


ER$ALN 


0006 


ER$ALQ 


0007 


ER$ANI 


0010 


ER$AOP 


0011 


ER$AST 


0012 


ER$A'1'K 


0013 


ER$ATW 


0014 


ER$BKS 


0015 


ER$BKZ 


0016 


ER$BLN 


0017 


ER$BOF 


0020 


ER$BPA 


0021 


ER$BPS 


0022 


ER$BUG 


0023 


ER$CCR 


0024 


ER$CHG 


0025 


ER$CHK 


0026 


ER$CLS 


0027 


ER$COD 



Unspecified error 

Operation aborted (STV = ER$STK/MAP) 

Fll-ACP could not access file (STV = sys err code) 

File activity precludes operation 

Bad area ID 

Alignment options error 

Allocation quantity too large or equal to 

Not ANSI-D format 

Allocation options error 

Invalid (i.e. synch) operation at AST level 

Attribute read error 

Attribute write error 

Bucket size too large 

Bucket size too large 

BLN length error 

Beginning of file detected 

Private pool address not multiple of 4 

Private pool size not multiple of 4 

Internal RMS error condition detected 

Cannot connect RAB 

$UPDATE changed a key without having attribute of 

XB$CHGset 

Bucket format check-byte failure 

RSTS/E close function failed 

Invalid or unsupported COD field 
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0030 


ER$CRE 


0031 


ER$CUR 


0032 


ER$DAC 


0033 


ER$DAN 


0034 


ER$DEL 


0035 


ER$DEV 


0036 


ER$DIR 


0037 


ER$DME 


0040 


ER$DNF 


0041 


ER$DNR 


0042 


ER$DPE 


0043 


ER$DTP 


0044 


ER$DUP 


0045 


ER$ENT 


0046 


ER$ENV 


0047 


ER$EOF 


0050 


ER$ESS 


0051 


ER$EXP 


0052 


ER$EXT 


0053 


ER$FAB 


0054 


ER$FAC 


0055 


ER$FEX 


0056 


ER$FID 


0057 


ER$FLG 


0060 


ER$FLK 


0061 


ER$FND 


0062 


ER$FNF 


0063 


ER$FNM 


0064 


ER$FOP 


0065 


ER$FUL 


0066 


ER$IAN 


0067 


ER$IFI 


0070 


ER$IMX 


0071 


ER$INI 


0072 


ER$IOP 


0073 


ER$IRC 


0074 


ER$ISI 


0075 


ER$KBF 


0076 


ER$KEY 


0077 


ER$KRF 


0100 


ER$KSZ 


0101 


ER$LAN 


0102 


ER$LBL 


0103 


ER$LBY 


0104 


ER$LCH 



Fll-ACP could not create file (STV = sys err code) 

No current record (operation not preceded by $GET/ 

$FIND) 

Fll-ACP deaccess error during close 

Date area number invalid 

RF A- Accessed record was deleted 

Bad device or inappropriate device type 

Error in directory name 

Dynamic memory exhausted 

Directory not found 

Device not ready 

Device has positioning error 

DTP field invalid 

Duplicate key detected, XB$DUP not set 

RSX-Fll ACP enter function failed 

Operation not selected in ORG$ macro 

End of file 

Expanded string area too short 

File expiration date not yet reached 

File extend failure 

Not a valid FAB (BID field not = FB$BID) 

Invalid FAC for REC-OP: 0, or FB$PUT not set for 

$CREATE 

File already exists 

Invalid file ID 

Invalid flag-bits combination 

File is locked by other user 

RSX-Fll ACP find function failed 

File not found 

Error in file name 

Invalid file options 

Device/file full 

Index area number invalid 

Invalid IFI value or unopened file 

Maximum NUM (254) areas/key XABS exceeded 

$INIT macro never issued 

Operation unknown or invalid for file organization 

Invalid record encountered (sequential files only) 

Invalid ISI value on unconnected RAB 

Bad key buffer address (KBF = 0) 

Invalid key field (KEY = or negative) 

Invalid key-of-reference ($GET/$FIND) 

Key size too large (IDX/NOT = :(REL)) 

Lowest level index area number invalid 

Not ANSI labeled tape 

Logical channel busy 

Logical channel number too large 
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0105 


ER$LEX 


0106 


ER$LOC 


0107 


ER$MAP 


0110 


ER$MKD 


0111 


ER$MRN 


0112 


ER$MRS 


0113 


ER$NAM 


0114 


ER$NEF 


0115 


ER$NID 


0116 


ER$NPK 


0117 


ER$OPN 


0120 


ER$ORD 


0121 


ER$ORG 


0122 


ER$PLG 


0123 


ER$POS 


0124 


ER$PRM 


0125 


ER$PRV 


0126 


ER$RAB 


0127 


ER$RAC 


0130 


ER$RAT 


0131 


ER$RBF 


0132 


ER$RER 


0133 


ER$REX 


0134 


ER$RFA 


0135 


ER$RFM 


0136 


ER$RLK 


0137 


ER$RMV 


0140 


ER$RNF 


0141 


ER$RNL 


0142 


ER$ROP 


0143 


ER$RPL 


0144 


ER$RRV 


0145 


ER$RSA 


0146 


ER$RSZ 


0147 


ER$RTB 


0150 


ER$SEQ 


0151 


ER$SHR 


0152 


ER$SIZ 


0153 


ER$STK 


0154 


ER$SYS 


0155 


ER$TRE 


0156 


ER$TYP 



Logical extend error, prior extend still valid 
LOG field invalid 
Buffer mapping error 

FllACP could not mark file for deletion 
MRN value = negative or relative key > MRN 
MRS value = for fixed length records or for relative 
files 

NAM block address invalid (NAM = or not acces- 
sible) 

Not positioned to EOF (sequential files only) 
Cannot allocate internal index descriptor 
No primary key defined for indexed file 
RSTS/E open function failed 

XABs not in correct order 

Invalid file organization value 

Error in file's prologue (reconstruct file) 

PCS field invalid (POS>MRS, STV = XAB indicator) 

Bad file date field retrieved 

Privilege violation (OS denies access) 

Not a valid RAB (BID field not = RB$BID) 

Invalid RAC value 

Invalid record attributes 

Invalid record buffer address (odd, or not word-aligned 

ifBLK-IO) 

File read error (STV = sys err code) 

Record already exists 

Bad RFA value (RFA = 0) 

Invalid record format 

Tanget bucket locked by another stream 

RSX-FllACP remove function failed 

Record not found 

Record not locked 

Invalid record options 

Error while reading prologue 

Invalid RRV record encountered 

RAB stream currently active 

Bad record size (RSZ>MRS, or not -MRS if fixed 

length records) 

Record too big for user's buffer 

Primary key out of sequence (RAC = RB$SEQ for 

$PUT) 

SHR field invalid for file (cannot share sequential files) 

SIZ field invalid 

Stack too big for save area 

System directive error 

Index tree error 

Error in file type; extension on FNS too big 
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0157 


ER$UBF 


0160 


ER$USZ 


0161 


ER$VER 


0162 


ER$VOL 


0163 


ER$WER 


0164 


ER$WLK 


0165 


ER$WPL 


0166 


ER$XAB 


0167 


BUGDDI 


0170 


CAA 


0171 


CCF 


0172 


CDA 


0173 


CHN 


0174 


CNTRLO 


0175 


CNTRLY 


0176 


DNA 


0177 


DVI 


0200 


ESA 


0201 


FNA 


0202 


FSZ 


0203 


lAL 


0204 


KFF 


0205 


LNE 


0206 


NOD 


0207 


NORMAL 


0210 


CK DUF 


0211 


CK_IDX 


0212 


CK RLK 


0213 


CK RRV 


0214 


CREATE 


0215 


PBF 


0216 


ENDING 


0217 


QUO 


0220 


RHB 


0221 


RLE 


0222 


RSS 


0223 


RST 


0224 


SQO 


0225 


sue 


0226 


SPRSED 


0227 


SYN 


0230 


TMO 


0231 


ER$BLK 


0232 


ER$BSZ 



Invalid user buffer address (0, odd, or if BLK-IO not 
word-aligned) 

Invalid user buffer size (USZ = 0) 

Error in version number 

Invalid volume number 

File write error (STV = sys err code) 

Device is write locked 

Error while writing prologue 

Not a valid XAB (@XAB = odd, STV = XAB indicator) 

Default directory invalid 

Cannot access argument list 
Cannot close file 
Cannot deliver AST 

Channel assignment failure (STV = sys err code) 
Terminal output ignored due to Control-O 
Terminal input aborted due to Control-Y 
Default file name string address error 
Invalid device ID field 

Expanded string address error 
File name string address error 
FSZ field invalid 
Invalid argument list 
Known file found 
Logical name error 
Node name error 
Operation successful 

Record inserted had duplicate key 

Index update error occurred; record inserted 

Record locked buy read anyway 

Record inserted in primary, buy may not be accessible 

by secondary keys or RFA 

File was created, but not opened 

Bad prompt buffer address 

Asynchronous operation pending completion 

Quoted string error 

Record header buffer invalid 

Invalid related file 

Invalid resultant string size 

Invalid resultant string address 

Operation not sequential 

Operation successful 

Created file superseded existing version 

File name syntax error 

Time-out period expired 

FB$BLK record attribute not supported 

Bad byte size 
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0233 ER$CDR Canot disconnect RAB 

0234 ER$CGJ Cannot get JFN for file 

0235 ER$COF Cannot open file 

0236 ER$JFN Bad JFN value 

0237 ER$PEF Cannot position to end of file 

0240 ER$TRU Cannot truncate file 

0241 ER$UDF File is currently in an undefined state; access is denied 

0242 ER$XCL File must be opened for exclusive access 

0243 Directory full 

0244 Handler not in system 

0245 Fatal hardware error 

0246 Attempt to write beyond EOF 

0247 Hardware option not present 

0250 Device not attached 

0251 Device already attached 

0252 Device not attachable 

0253 Sharable resource in use 

0254 Invalid overlay request 

0255 Block check or CRC error 

0256 Caller's nodes exhausted 

0257 Index file full 

0260 File header full 

0261 Accessed for write 

0262 File header checksum failure 

0263 Attribute control list error 

0264 File already accessed on LUN 

0265 Bad tape format 

0266 Invalid operation on file descriptor block 

0267 2 different devices specified on a rename 

0270 New file name specified in rename already in use 

0271 Cannot rename old system 

0272 File already open 

0273 Parity error on device 

0274 End of volume detected 

0275 Data over-run 

0276 Bad block on device 

0277 End of tape detected 

0300 No buffer space for file 

0301 File exceeds allocated space; no blocks 

0302 Specified task not installed 

0303 Unlock error 

0304 No file accessed on LUN 

0305 Send/receive failure 

0306 SPL Spool or submit command file failure 

0307 NMF No more files 

0310 CRC DAP file transfer checksum error 

0311 Quota exceeded 
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0312 


BUGDAP 


0313 


CNTRLC 


0314 


DFL 


0315 


ESL 


0316 


IBF 


0317 


IBK 


0320 


IDX 


0321 


IFA 


0322 


IFL 


0323 


KNM 


0324 


KSI 


0325 


MBC 


0326 


NET 


0327 


CK ALK 


0330 


CK DEL 


0331 


CK TJM 


0332 


CK_NOP 


0333 


CK_RNF 


0334 


PLV 


0335 


REF 


0336 


RSL 


0337 


RVU 


0340 


SEG 


0341 




0342 


SUP 


0343 


WBE 


0344 


WLD 


0345 


WSF 


0346 




0347 




0350 




0351 




0352 




0353 




0354 


SNE 


0355 


SPE 


0356 


UPI 


0357 


ACS 


0360 


TNS 



Internal network error condition detected 
Terminal input aborted due to Control-C 
Data bucket fill size > bucket size in XAB 
Invalid expanded string length 
Invalid bucket format 
Bucket size of LAN not = IAN in XAB 

Index not initialized 

Invalid file attributes (corrupt file header) 
Index bucket fill size > bucket size in XAB 
Key name buffer not readable or writeable in XAB 
Index bucket will not hold two keys for key of refer- 
ence 

Multi-buffer count invalid (negative value) 
Network operation failed at remote node 
Record is already locked 

Deleted record successfully accessed 

Retrieved record exceeds specified key value 

Key XAB not filled in 

Nonexistent record successfully accessed 

Unsupported prologue version 

Invalid key-of-reference in XAB 

Invalid resultant string length 

Error updating RRVs; some paths to data may be lost 

Data types other than string limited to one segment in 

XAB 

Reserved 

Operation not supported over network 

Error on write behind 

Invalid wildcard operation 

Working set full (cannot lock buffers in working set) 

Directory listing; error in reading volume-set name, 

directory name, or file name 

Directory listing; error in reading file attributes 

Directory listing; protection violation in trying to read 

the volume-set, directory or file name 

Directory listing; protection violation in trying to read 

file attributes 

Directory listing; file attributes do not exist 

Directory listing; unable to recover directory list after 

Continue Transfer (Skip) 

Sharing not enabled 

Sharing page count exceeded 

UPI bit not set when sharing with BRO set 

Error in access control string (poor man's route 

through error) 

Terminator not seen 
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0361 BES Bad escape sequence 

0362 PES Partial escape sequence 

0363 WCC Invalid wildcard context value 

0364 IDR Invalid directory rename operation 

0365 STR User structure (FAB/RAB) became invalid during 

operation 

0366 FTM Network file transfer mode precludes operation 

6000 to 7777 User defined errors 



Micro innnn) values for use with macro iaa) value of 12 octal are listed 
below. This refers to the macro Synchronization category. 

NOTE 

Micro (nnnn) Format: Bits 0-11 contains message type 
number. 

0000 Unknown 

0001 Configuration 

0002 Attributes 

0003 Access 

0004 Control 

0005 Continue transfer 

0006 Acknowledge 

0007 Access complete 

0010 Data 

0011 Status 

0012 Key definition attributes 

00 1 3 Allocation attributes extension 

0014 Summary attributes extension 

0015 Date and time attributes extension 

0016 Protection attributes extension 

0017 Name 

0020 Access control list extended attributes 
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INDEX 



Access control information, 

See Log-in information 
Account ID, 4-6, 4-20, C-2 
Active nodes, 2-2, 4-6 
Adjacent node, 1-2 

APPEND command (NFT), 4-9, 4-11 to 4-12 
/APPEND switch (NFT), 4-9, 4-29 
Appending files, 4-11, 4-29 
Automatic log-in, 

See NETACT 



B 



BATCH, 

submitting files, 4-24 
Binary files, 4-29 
Block size on device transfer, 5-4 
/BLOCK switch (NETCPY), 5-4 
/BLOCK switch (NFT), 4-29 to 4-30 
Block transfer, 

verification, 5-6 
/BRIEF switch (NFT), 4-30 



Carriage control, 4-34 
CCL command formats, 

NET, 3-2 

NFT, 4-4 

TLK, 2-2, 2-4 
Compatibility, 

Phase II, 1-5 
Concise Command Language, 

See CCL 
Contiguous files, 

allocation, 4-30 
/CONTIGUOUS switch (NFT), 4-30 
CONTINUE command (NET), 3-4 
COPY command (NFT), 4-13 to 4-14 
Copying devices, 5-1 
Copying files, 4-13 
Cost, 1-5 
CRC, 1-4 

/CTG switch (NFT), 4-30 
CTRL/P command (NET), 3-4 to 3-5 
Cyclic Redundancy Check, 

See CRC 



DAP, 1-4, 4-1, 4-3, 4-37 

version number, 4-27 
Data Access Protocol, 

See DAP 
DCL Run-Time System, 3-3, 4-4 
DDCMP, 1-4, 1-6 

DEFINE command (NETACT), C--2 
DELETE command (NFT), 4-15 
Deleting Files, 4-34 
/DENSITY switch (NETCPY), 5-4 
Devices, 

busy, 4-7 

copying, 5-1 

density, 5-4 

DMx controllers, 1-6 

magnetic tape, 4-7, 4-35 to 4-36, 5-4, 5-6 

parity, 5-6 

software drivers, 1-6 

specification (NETCPY), 5-2, 5-3 

specification (NFT), 4-7 

specification (TLK), 2-2, 2-3, 2-4 

verification of transfer, 5-6 
Dialog mode (TLK), 2-4 to 2-7 
Digital Data Communications Message Protocol, 

See DDCMP 
DIGITAL Network Architecture, 

See DNA 
DIRECTORY command (NFT), 4-16 to 4-17 
Directory listings (NFT), 4-30 to 4-32, 4-35, 4-36 
Directory names, 4-7 to 4-8, 4-20 
DMx controllers, 1-6 
DNA, 1-3 to 1-4 



Encryption of password, C-2 
End node, 1-4 
Error messages, 

DAP, D-9 to D-22 

NET, 3-9 

NETACT, C-4 

NETCPY, 5-7 to 5-8 

NFT, 4-37 to 4-39 

RMS, D-1 to D-9 

TLK, 2-7 to 2-10 
EXIT command (NET), 3-5 to 3-6 
EXIT command (NETACT), C-2 to C-3 
EXIT command (NFT), 4-18 



Index 



FAL, 4-3 
Fast copy, 

NETCPY, 5-5 
/FC switch (NETCPY), 5-3, 5-5 
File Access Listener, 

See FAL 
Files, 

appending with NFT, 4-11, 4-29 

attributes, 4-9, 4-11, 4-29, 4-32, 4-83 to 4-34, 
4-36 to 4-37 

binary, 4-29 

block transfer, 4-29 to 4-30 

contiguous allocation, 4-30 

copying with NFT, 4-13 

deleting, 4-15, 4-34 

directory listings, 4-16 

image, 

See Binary files 

name and type, 4-8 

noncontiguous allocation, 4-34 

printing with NFT, 4-22 

specification (NFT), 4-7 to 4-8 

stream ASCH, 4-33 to 4-34, 4-37 

submitting to BATCH, 4-24 

superseding existing, 4-35 to 4-36 

variable-length records, 4-34, 4-36 to 4-37 

virtual array data, 4-29 
/FULL switch (NFT), 4-31 



H 



HELP command (NET), 3-7 
HELP command (NETACT), C-3 
HELP command (NFT), 4-19 
/HELP switch (NETCPY), 5-5 
Hop, 1-2 



/IDENTIFY switch (NFT), 4-4, 4-31 to 4-32, C-1 
Image files, 

See Binary files 
/INQUIRY switch (NFT), 4-9, 4-32 



Line input (NET), 3-7 to 3-8 
Link, 

logical, 1-2, 1-4, 4-3 

physical, 1-2, 1-6 
LIST command (NETACT), C-3 
/LIST switch (NFT), 4-32 
Local node, 1-2 
/LOG switch (NFT), 4-33 
Log-in, 

automatic. 

See NETACT 
Log-in information, 

NETCPY, 5-1 

NFT, 4-4, 4-6 to 4-7, 4-20, 4-31, C-1 
Logical link, 1-2, 1-4, 4-3 
LSN, 2-1, 2-3, 2-5 



M 



Magnetic tape, 4-7, 4-35 to 4-36, 5-4, 5- 
/MORE switch (NFT), 4-33 
Multipoint lines, 1-6 



Keyboard modes, 3-3 



N 



Named directories, 4-7 to 4-8, 4-20 
/NATIVE switch (NFT), 4-33 to 4-34 
/NC switch (NETCPY), 5-3, 5-5 
NCP, 1-5 to 1-6, 4-6 

NET (Network Command Terminal Utility), 1-4, 
1-6, 3-1 to 3-9 

capabilities, 3-1 

CCL command format, 3-2 

commands, 3-3 to 3-9 

error messages, 3-9 

line input, 3-7 to 3-8 

node specification, 3-2 

running, 3-2 to 3-3 

single-character input, 3-7 to 3-8 
NETACT (Automatic Log-in Utility), 4-4, C-1 to 
C-4 

commands, C-2 to C-3 

error messages, C-4 

running, C-1 
NETCPY (Network Copy between Devices), 1-4, 1-6, 
5-1 to 5-8 

allowable devices, 5-2, 5-3 

capabilities, 5-2 

command format, 5-2 

device specification, 5-2 to 5-3 

error messages, 5-7 to 5-8 

log-in information, 5-1 

node specification, 5-2 to 5-3 

running, 5-2 

switches, 5-4 to 5-6 

verifying transfer, 5-6 
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NETOFF (Network Shutdown), 6-1 to 6-2 
Network Command Terminal Utility, 

See NET 
Network Control Program, 

See NCP 
Network copy between devices, 

See NETCPY 
Network diameter, 1-2 
Network File Transfer, 

See NFT 
Network Services Protocol, 

See NSP 
Network shutdown. 

See NETOFF 
NFT (Network File Transfer Utility), 1-4, 1-6, 
4-1 to 4-39 

appending files, 4-11 to 4-12, 4-29 

capabilities, 4-1 

CCL command format, 4-4 

command format, 4-5 to 4-9 

commands, 4-10 to 4-27 

continuing command line, 4-33 

copying files, 4-13 

deleting files, 4-15, 4-34 

device specification, 4-7 

directory listings, 4-16, 4-30 to 4-31, 4-32, 
4-35 to 4-36 

error messages, 4-37 to 4-39 

error messages from DAP, D-9 to D-22 

error messages from RMS, D-1 to D-9 

file specification, 4-7 to 4-8 

log-in information, 4-4, 4-6 to 4-7, 4-20, 4-31, C-1 

node specification, 4-5 to 4-6 

printing files, 4-22 

quoted strings, 4-9 

running, 4-4 to 4-5 

switches, 4-28 to 4-37 

wildcards, 4-8 to 4-9 
/NOCONTIGUOUS switch (NFT), 4-34 
Node, 1-2 

active, 2-2, 4-6 

adjacent, 1-2 

end, 1-5 

local, 1-2 

nonrouting, 1-5 

Phase II, 1-5 

remote, 1-2 

routing, 1-5 

specification (NET), 3-2 

specification (NETCPY), 5-2 to 5-3 

specification (NFT), 4-5 to 4-6 

specification (TLK), 2-2, 2-3, 2-4 
/NODELETE switch (NFT), 4-34 
NODESPECIFICATION command (NFT), 4-4, 4-20 

to 4-21, C-1 
/NOHEADING switch (NFT), 4-35 
Noncontiguous files, 

allocation, 4-34 
Nonrouting node, 1-5 



NORMAL command (NET), 3-7 to 3-8 
/NOSUPERSEDE switch (NFT), 4-35 
NPKDVR, 3-1 to 3-2, 3-5 
NSP, 1-4 to 1-5 
reason codes, B-1 



Object type codes, A-1 
Octal Debugging Tool, 

See ODT 
ODT (Octal Debugging Tool), 3-8 
ODT command (NET), 3-8 to 3-9 
One-line mode (TLK), 2-2 to 2-4 
Operator Services Program, 

See OPSER 
OPSER, 2-3, 2-6 



/PARITY switch (NETCPY), 5-6 
Password, 4-6, 4-20, 5-2, C-23 

encryption, C-2 
Patch, 

routing, 1-2 

length, 1-2 
Peripheral Interchange Program, 

See PIP 
Phase II node, 1-5 
Physical link, 1-2, 1-6 
PIP, 4-30 to 4-32 
Point-to-point lines, 1-6 
/POS switch (NFT), 4-35 
PPN, 4-6, 4-8, 4-20, 5-2, C-2 

wildcarding, 4-8 
PRINT command (NFT), 4-22 to 4-23 
Printing files with NFT, 4-22 
Project-programmer number. 

See PPN 
Protocols, 1-4 

DAP, 1-4, 4-3 

DDCMP, 1-4, 1-6 

NSP, 1-4 to 1-5 

TRN, 1-4, 1-6 
Pseudo-keyboard driver, 

See NPKDVR 
PURGE command (NETACT), C-3 



Quote characters, 

NFT, 4-9 
Quoted strings (NFT), 



4-9 
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Reason Codes (NSP), 

for Connect Reject and Link Abort, B-1 
Record Management Services, 

See RMS 
Remote node, 1-2 
RMS, 4-3, 4-34, 4-36 to 4-37 
Routing, 1-2, 1-5 

cost, 1-5 

hop, 1-2 

network diameter, 1-2 

path, 1-2 

path length, 1-2 
Routing node, 1-5 
/RWC switch (NFT), 4-36 
/RWO switch (NFT), 4-36 



SHOW ACTIVE NODES, 4-6 
Single-character input (NET), 3-7 to 3-8 
Spooler, 

submitting to remote, 4-22 
Stream ASCII, 4-33 to 4-34, 4-37 
Strings, 

quoted (NFT), 4-9 
SUBMIT command (NFT), 4-24 to 4-25 
/SUPERSEDE switch (NFT), 4-36 
Superseding files, 4-35 to 4-36 
Switches, 

NETCPY, 5-4 to 5-6 

NFT, 4-28 to 4-37 



capabilities, 2-1 

CCL command format, 2-2, 2-4 

device specification, 2-2 to 2-4 

dialog mode, 2-4 to 2-7 

error messages, 2-7 to 2-10 

node specification, 2-2 to 2-4 

one-line mode, 2-2 to 2-4 

terminal listener (LSN), 2-1, 2-3, 2-5 
/TOTAL switch (NFT), 4-36 
Transport Protocol, 

See TRN 
TRN, 1-4, 1-6 
TYPE command (NFT), 4-26 



u 



UIC, 

See PPN 
User Identification Code, 

See PPN 



/VARIABLE switch (NFT), 4-36 to 4-37 
Variable-length record files, 4-34, 4-36 
/VERIFY switch (NETCPY), 5-6 
VERSION command (NFT), 4-27 
Version number 

DAP, 4-27 
Virtual array data files, 4-29 
Virtual terminal. 

See NET 



Terminal Communication Utility, 

See TLK 
Terminal Listener, 

See LSN 
TLK (Terminal Communication Utility), 1-4, 1-6, 
2-1 to 2-10 



w 

Wildcards, 4-32 

NFT commands, 4-8 to 4-9 
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NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
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